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FOREWORD 


This  program  was  originally  issued  In  December  1968.  Since  then  it  has 
undergone  several  revisions  to  make  it  more  efficient  and  useful.  The 
most  recent  revision  has  been  to  restructure  the  input  data  require¬ 
ments  to  improve  input  preparation.  Earlier  revisions  have  been  retained, 
and  in  some  cases  improved.  The  program  is  primarily  used  to  simulate 
reservoir  systems  for  conservation  purposes.  Other  Hydrologic  Engineer¬ 
ing  Center  programs  are  available  to  simulate  other  hydrologic  aspects 
of  a  system  -  HEC-1  for  rainfall -runoff  modeling;  HEC-2  for  modeling 
stream  channel  hydraulics;  HEC-5  for  flood  control  systems  analysis. 
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1.  ORIGIN  OF  PROGRAM 

This  program  is  the  fourth  generation  of  a  program  originally  developed 
in  196b-19b6  at  The  Hydrologic  Engineering  Center  by  Mr.  Leo  R.  Beard.  Since 
the  initial  version  was  issued  many  modifications  have  been  made  to  increase 
the  capability  of  the  program,  and  the  program  has  undergone  extensive  test¬ 
ing.  The  primary  modification  incorporated  into  the  version  described  herein 
is  a  complete  revision  of  the  input  structure.  The  primary  purposes  of  mod¬ 
ifying  the  input  structure  were  to  simplify  input  preparation  and  to  facili¬ 
tate  changes  in  input  required  for  sensitivity  studies  and  studies  of  alter¬ 
native  system  configurations. 

2.  PURPOSE  OF  PROGRAM 

The  program  simulates  the  operation  of  a  reservoir  system  for  such 
conservation  purposes  as  water  supply,  navigation,  recreation,  low-flow 
augmentation  and  hydroelectric  power.  While  flood  control  operations  can 
be  handled  in  some  respects,  a  more  complete  simulation  is  possible  using 
HEC-5  "Reservoir  System  Operation  for  Flood  Control."  The  program  can 
accept  any  configuracion  of  reservoirs,  diversions,  powerplants  and  stream 
control  points.  Economic  values  can  be  computed  for  meeting  selected  targets. 

3.  DESCRIPTION  OF  EQUIPMENT 

The  program  was  designed  for  use  on  a  large  computer  such  as  the  COC 
6600,  Honeywell  625  or  IBM  360/50.  It  can  be  used  on  medium-si  zed  computers 
such  as  the  Honeywell  400,  but  the  size  of  the  system  that  can  be  studied 
is  reduced  and  the  run  times  may  be  considerably  longer.  Four  magnetic 
tape  units  or  other  file  devices  are  required  in  addition  to  input  and 
output  files. 


4.  DESCRIPTION  OF  PROGRAM 
a.  System  Components. 

(1)  There  are  five  basic  system  components  which  are  used  by 
the  program  to  model  a  reservoir  system.  These  are  the  system  hydrology, 


reservoirs,  control  points,  powerplants  and  diversions.  To  capture  the 
essence  of  tile  real  system  it  is  necessary  to  describe  each  component, 
quantitatively  or  mathematically,  in  sufficient  detail.  In  the  sections 
which  follow  important  characteristics  of  each  component  are  discussed. 
Interrelationships  between  components  are  discussed  under  system  operation. 

b.  hydrologic  Characteristics. 

(1)  Inflows.  The  system  inflows  are  the  primary  hydrologic 
component  of  the  program.  To  describe  the  inflow  it  is  necessary  to 
identify  the  location,  i.e.,  control  point  where  they  occur,  their 
magnitude  and  the  time  period  when  they  occur.  This  time  period 

is  described  by  specifying  the  number  of  years  of  data,  the  number  of 
periods  per  year  and  number  of  days  per  period.  In  most  cases  the  time 
interval  is  taken  to  be  a  month,  thus  the  simulation  usually  performs  a 
..son Lilly  routing  of  flov/s. 

(2)  Local  Flows.  Incremental  local  flows  are  flows  whlcn  arc 
equal  to  the  difference  between  inflows  at  adjacent  control  points, 
emulative  local  flows  are  equal  to  the  Jifference  between  the  inflows 

at  a  certain  control  point  and  the  inflows  from  all  reservoirs  immediately 
jL”j/o  that  control  point  such  that  if  the  above  reservoir  releases  are 
added  ;o  the  cumulative  local  flow  the  resulting  flow  would  be  the  regu¬ 
lated  flow. 

(3)  Evaporation.  Reservoir  evaporation  is  an  important  part  of 
tin:  system's  water  balance  computation  and  is  input  into  the  model  by 
specifying  a  net  evaporation  rate  (difference  between  evaporation  and 
rainfall)  for  each  reservoir.  This  rate  may  be  made  the  same  for  all 
reservoirs  and  all  years,  varied  by  time  period,  or  varied  by  reservoir. 

c .  Reservoir  Characteristics. 

(1)  Elevation,  Storage,  Surface  Area,  Outlet  Capacity.  These 
■Jiaracteristics  describe  important  physical  features  of  each  reservoir 
and  are  necessary  to  model  the  storage  and  release  features  of  the 
reservoir.  For  a  particular  reservoir,  each  reservoir  elevation  has 
associated  with  it  a  specific  storage  capacity,  surface  area  and  outlet 
capacity.  Leakage  through  or  under  a  dam  or  powerhouse  may  also  be 
specified. 

(i)  Operating  Criteria.  To  simulate  the  operation  of  a  reservoir 
system  the  operating  criteria  must  be  expressed  in  quantitative  or  mathe- 
ia tied  1  terms.  The  primary  Mechanism  for  doing  this  is  by  dividing  the 
reservoir  into  imaginary  Horizontal  levels.  Corresponding  to  each  level 
is  a  reservoir  elevation,  storage,  surface  area  and  outlet  capacity. 
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Differences  between  levels  are  zones  of  potential  storage  volume.  The  lowest 
level  corresponds  to  the  bottom  of  the  conservation  pool  (top  of  inactive 
pool),  the  second  lowest  level  is  the  <,op  of  the  buffer  zone,  the  highest 
level  is  the  full  pool  level  (top  of  flood  control),  and  the  second  highest 
level  is  the  top  of  conservation  (bottom  of  flood  control).  Additional 
levels  can  be  established  to  facilitate  individual  reservoir  operating 
criteria. 

Each  reservoir  is  operated  to  meet  streainflow  targets  at  specified 
locations  in  the  system.  These  operational  points  are  specified  for  each 
reservoir  by  identifying  those  points  for  which  the  reservoir  does  not 
operate.  Priority  of  withdrawals  from  reservoirs  serving  the  same  location 
can  be  established  by  specifying  additional  levels.  The  highest  storage  zone 
is  withdrawn  from  first,  then  the  second  highest  and  so  on  down  to  the  lowest 
keeping  all  reservoirs  in  the  system  in  balance  to  the  extent  possible.  A 
numerical  example  of  this  leveling  technique  appears  in  exhibit  1. 

Other  operating  criteria  specified  in  the  model  are  initial  reservoir 
storage  and  spillway  surcharge.  An  initial  storage  must  be  specified  to 
begin  the  simulation.  This  may  be  an  actual  or  assumed  value.  During 
flood  operations  inflow  causing  a  reservoir  to  rise  above  its  top  of  flood 
control  level  must  be  either  spilled  or  stored  in  surcharge  storage.  Water 
spilled  may  be  released  into  the  stream  below  the  reservoir  or  to  a  diver¬ 
sion  if  one  exists.  The  other  alternative  is  to  specify  that  the  excess 
be  stored  in  surcharge  storage. 

(3)  Hydrologic  Balance.  Computations  in  the  model  are  based  on 
the  principle  of  continuity  as  expressed  by  the  equation 


si 


S.  ,  +  I. 
i-l  i 


where, 

S.  =  reservoir  storage  volume  at  the  end  of  the  current 
1  period,  i 

S-i  =  reservoir  storage  volume  at  the  end  of  the  previous 
period,  i-1 

1^  =  inflow  volume  during  period  i 

Q.j  =  release  volume  during  period  i 

and  =  net  evaporation  volume  during  period  i 

This  basic  equation,  when  I,  Q,  and  E  are  properly  defined,  is  appropriate 
for  storage  accounting  v/here  the  length  of  the  period  i  is  long  compared 
to  the  travel  time  through  the  reservoir.  It  should  be  noted  that  proper 
definition  of  I  implies  that  all  diversions  into  the  reservoir  and  releases 
from  upstream  reservoirs  must  be  added  to  the  natural  inflow  to  obtain  the 
inflow  volume;  that  proper  definition  of  Q  implies  that  all  diversions  out 
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of  the  reservoir,  leakage  from  the  reservoir,  and  releases  for  different 
purposes  are  added  together  to  obtain  the  total  release  volume;  and  that 
F:  must  reflect  the  gain  or  loss  in  reservoir  storage  volume  that  would 
occur  as  a  result  of  net  evaporation  (evaporation  minus  precipitation) 
over  the  impoundment  area  during  the  period. 

d.  Control  Point  Characteristics. 

(1)  Control  points,  which  are  not  reservoirs,  are  used  to  regulate 
system  operation  by  establishing  constraints  and  targets  on  streamflow.  Both 
reservoirs  and  selected  locations  along  the  stream  network  are  assigned  con¬ 
trol  point  numbers.  There  are  three  types  of  controls  which  may  be  spec¬ 
ified  for  any  stream  control  point:  maximum  permissible  flow,  minimum 
desired  flow,  minimum  required  flow.  Maximum  permissible  flow  places  an 
upper  limit  on  the  desired  magnitude  of  the  streamflow  at  the  selected 
point.  This  limit  is  maintained  unless  upstream  reservoir  flood  control 
storage  is  exceeded  and  operation  requires  spilling  excess  water.  Minimum 
desired  flow  is  a  target  flow  which  is  sought  while  reservoirs  are  operat¬ 
ing  in  the  conservation  pool  above  the  top  of  buffer  zone.  When  the 
reservoir  levels  go  into  the  buffer  zone  the  minimum  required  flow  becomes 
the  target.  Eacn  flow  requirement  may  be  constant,  or  vary  for  each 
period. 


Each  control  point  is  assigned  both  a  number  and  name  and  those 
reservoirs  in  the  system  which  will  operate  to  meet  the  target  flows  of 
that  control  point  are  identified. 

e.  Powerplant  Characteristics. 

(1)  Power  calculations  are  based  on  the  equation 

GEi  *  KQi  •  hi  •  ei  '  1 

wnere, 

K  =  .08464  for  English  units,  9.817  for  Metric  units 

GE^  *  energy  in  kilowatt-hours  generated  during  period  i 

Q.  s  average  flow  in  cfs  (m3/sec)  through  the  generating 
units  during  period  i 

h..  =  average  effective  head  in  feet  (meters)  on  the 
turbine  during  period  i 

e^  =  efficiency  of  the  generating  units  during  period  i 
t  =  hours  in  period  i 

This  equation  is  appropriate  for  use  when  has  been  defined  as  only  that 
part  of  the  release  volume  which  passes  through  the  generating  units,  when 
hj  is  defined  as  the  head  which  exists  during  the  period  i  (calculated  by 
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subtracting  tailwater  elevation  and  head  loss  from  the  reservoir  surface 
elevation),  and  when  e^  reflects  the  average  overall  station  efficiency 
during  period  i.  The  calculation  of  head  is  based  on  the  elevation  corres¬ 
ponding  to  mean  reservoir  storage  for  the  current  period  (average  of  the 
beginning  and  ending  reservoir  storage)  and  the  tailwater  elevation  is 
specified  as  either  a  constant  value,  or  a  function  of  the  mean  release 
rate  for  the  period,  or  a  function  of  the  pool  elevation  of  a  downstream 
reservoir. 

(2)  Powerplant  characteristics  which  are  used  in  the  model  to 
simulate  power  operations  include, 

*  installed  powerplant  nameplate  capacity 

*  maximum  plant  factor  for  generation 

*  powerplant  efficiency 

*  tailwater  elevation  plus  hydraulic  loss 

*  overload  ratio  for  the  power  installation 

*  power  load  requirements  for  each  plant  for  each  time  period 

In  addition  several  functional  relationships  are  sometimes  necessary  for 
reservoir  operation  and  power  production.  These  include, 

*  power  releases  vs.  power  tailwater  elevation 

*  maximum  peaking  capability  vs.  reservoir  storage  or 
reservoir  release 

*  powerplant  efficiency  vs.  reservoir  storage 

f.  Diversions.  One  diversion  may  exist  at  any  control  point,  and  may 
be  specified  as  the  actual  flow  diverted,  or  as  a  function  of  the  natural 
flow,  regulated  flow,  or  reservoir  storage.  Diversion  requirements  may  be 
specified  constant  for  each  period,  or  varied  feach  year,  A  diversion  can 
also  be  used  to  accommodate  flood  flow  above  the  top  of  flood  control  pool. 

g.  Economic  Evaluation. 

(1)  An  economic  analysis  of  the  system  operation  is  available  at 
each  control  point  by  specifying  a  functional  relationship  between  a  hydro- 
logic  quantity  such  as  streamflow,  reservoir  storage,  power  generation  and 
the  economic  value  of  meeting  these  hydrologic  quantities  during  a  given 
time  period,  normally  a  month.  A  different  economic  function  may  be 
specified  for  each  purpose.  Thus,  at  each  control  point,  for  each  purpose 
and  for  each  time  period  the  program  will  compute  the  economic  value  of  the 
particular  hydrologic  quantity  and  sum  these  over  the  period  of  analysis. 

(2)  The  net  economic  gain  between  a  preproject  (natural)  system 
and  one  with  projects  is  measured  by  determining  the  economic  value  using 
unregulated  flows  and  regulated  flows  and  the  specified  economic  function. 
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This  will  give  the  gain  of  the  system  as  a  whole.  The  contribution  of  any 
one  project  is  best  measured  by  simulating  the  operation  of  the  system  with 
and  without  that  project.  An  alternative  approach  is  available  in  the  pro¬ 
gram  which  assigns  economic  values  to  upstream  reservoirs.  Using  this 
approach,  the  difference  between  project  and  preproject  economic  values 
are  allocated  in  direct  proportion  to  the  change  in  storage  at  the  various 
upstream  reservoirs.  When  a  reservoir  has  a  change  in  storage  which  is 
opposite  in  sign  to  the  net  change  of  all  upstream  reservoirs  operating 
for  that  control  point,  an  economic  contribution  of  zero  is  assigned  to  that 
particular  reservoir. 

h.  System  Operation. 

(1)  The  simulation  model  operates  by  considering  the  water  and 
power  requirements  at  each  pertinent  control  point  in  the  system  in  a 
sequential  fashion,  beginning  at  an  upstream  point  and  moving  in  a  downstream 
direction  through  each  river  basin.  The  release  required  to  meet  these 
requirements  for  all  pertinent  purposes  is  determined  by  evaluating  each 
operational  requirement  and  all  physical  and  operational  constraints  at 

each  site.  Also,  an  index  of  the  relative  state  of  each  reservoir  (usually 
a  function  of  reservoir  storage)  is  determined  according  to  the  specified 
operation  guides.  After  requirements  have  been  met  at  all  control  points 
(or  shortages  declared  if  upstream  water  is  not  available),  "system  require¬ 
ments"  are  examined  to  determine  whether  additional  water  releases  or  power 
generation  will  be  needed  to  satisfy  the  system  power  demands.  If  so,  the 
additional  needs  are  proportioned  among  projects  that  have  been  specified 
to  be  available  for  meeting  that  system  requirement  in  accordance  with  the 
relative  state  of  the  projects  as  evidenced  by  the  indices  previously  com¬ 
puted.  The  additional  releases  are  added  to  the  previously  computed 
releases  for  meeting  at-site  requirements,  and  the  system  and  at-site 
requirements  are  thus  met  (or  system  and  at-site  shortages  are  declared 
if  water  is  not  available).  This  process  is  repeated  for  each  period  of 
the  study,  with  the  ending  state  of  the  projects  in  the  system  for  the 
current  period  being  the  beginning  state  for  the  next  period. 

(2)  Results  from  the  successive  applications  of  these  calculations 
on  a  period-by-period  basis  are  recorded  for  all  points  in  the  system 
(including  nonreservoirs)  by  an  accounting  procedure  which  simply  accounts 
for  the  movement  of  the  water  through  the  system  by  using  the  specified 
relative  location  of  the  reservoirs  and  downstream  control  points.  By 
adding  releases  to  local  streamflow  to  obtain  total  streamflow,  and  by 
adding  inflows  to  storage  volume  and  subtracting  releases  from  storage 
volumes  the  state  of  any  component  and  the  flow  at  any  point  in  the  system 
can  be  calculated.  As  these  results  are  calculated  they  are  stored  and 
finally  printed  out,  normally  a  year  at  a  time  on  a  project-by-project 
basis,  to  produce  a  continuous  record  of  inflow,  storage,  outflow,  power 
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generation,  and  other  pertinent  data.  These  results  may  be  automatically 
rearranged  in  many  ways  to  serve  various  needs  in  analysis  or  evaluation  of 
the  system  operation. 

(3)  System  power.  Where  many  powerplants  are  included  in  one 
system,  it  is  often  desirable  to  specify  requirements  for  the  system  as  a 
whole  as  well  as  minimum  requirements  for  each  plant.  When  system  require¬ 
ments  are  specified,  it  is  also  necessary  to  specify,  for  each  plant,  the 
maximum  generation  usable  in  meeting  system  requirements.  The  maximum  is 
usually  specified  as  a  plant  factor. 

Uuring  the  first  search  of  the  system,  the  minimum  power  require¬ 
ment  at  each  plant  will  be  established,  and  the  total  generation  during  the 
period  at  each  plant  will  be  computed.  This  total  can  exceed  the  minimum 
required  generation  if  other  services  call  for  additional  releases  from 
the  particular  reservoir. 

At  the  end  of  the  first  search,  a  summary  is  made  of  the  total 
power  generated  and  required  and  of  the  total  power  generated  and  usable 
to  satisfy  system  requirements.  If  the  system  requirement  has  not  been 
satisfied,  water  levels  at  those  reservoirs  where  additional  generated 
power  could  be  usable  for  meeting  system  requirements  would  then  be  drawn 
toward  a  common  storage-balancing  level  such  that  the  full  system  require¬ 
ment  is  generated.  The  allocated  system  requirements  are  then  used  in 
making  a  second  search  of  the  entire  system  for  all  purposes. 

Since  satisfying  these  additional  requirements  will  usually 
change  releases  at  many  reservoirs,  the  average  head  during  the  second 
search  will  be  different  from  the  average  obtained  from  the  first  search 
and  used  in  the  second  search.  Accordingly,  accurate  system  power  (and 
evaporation)  computations  require  a  third  complete  search  of  the  entire 
water  resource  system  for  each  operation  period. 

5.  INPUT 

Input  data  preparation  is  described  in  detail  in  exhibit  4.  Example 
problems  illustrating  input  preparation  are  shown  in  exhibit  2. 

6.  OUTPUT 

Numerous  options  are  available  for  data  output  and  these  are  described 
in  exhibit  4  on  input  preparation.  Exhibit  3  contains  a  detailed  descrip¬ 
tion  of  output  data  and  exhibit  2  snows  output  for  the  example  problems. 
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APPENDIX  I 


I  FLOW  ROUTINE 


The  IFLOW  routine  permits  the  user  to  automatically  determine  the  firm 
yield  for  water  supply  at  one  control  point  in  a  reservoir  system.  To  use 
this  program  capability,  the  identification  number  of  the  control  point  is 
entered  in  field  8  of  the  Jl  card  and  an  estimate  of  the  firm  yield  is 
entered  as  QMN  (ID.2),  on  QD  cards,  or  on  YQ  cards.  The  program  executes 
a  normal  routine  sequence  with  the  historic  flow  data  supplied.  If  the 
desired  flow  at  the  control  point  in  question  is  not  met,  the  water 
shortage  index  is  used  to  calculate  a  reduction  coefficient  which  is  used 
to  set  a  new,  lower  desired  flow.  If  the  desired  flow  is  met  with  no 
shortage,  the  storage  remaining  in  the  conservation  pools  of  the  reservoirs 
serving  the  control  point  of  interest  is  used  to  calculate  an  increase 
coefficient  which  is  used  to  set  a  new,  higher  desired  flow.  The  program 
then  executes  a  second  routing  sequence  with  the  same  system  and  hydrologic 
data.  The  desired  flow  at  the  control  point  under  study  is  checked  again. 
If  the  previously  calculated  quantity  is  not  obtained  without  shortage  or 
storage  remaining  in  the  reservoirs,  a  further  revision  of  the  desired  flow 
is  calculated.  Through  a  series  of  approximations,  the  firm  yield  is 
finally  determined.  The  initial  estimate  may  be  either  too  high  or  too 
low  and  the  program  will  automatically  raise  or  lower  the  value  to  converge 
on  the  firm  yield.  All  printout  is  suppressed  during  the  routing  sequences 
with  approximate  values  and  only  the  routing  with  the  desired  flow  equal  to 
firm  yield  is  printed. 


AI 


APPENDIX  II 


IDVSP  ROUTINE 


The  IDVSP  option  permits  the  user  to  determine  and  to  re¬ 
route  the  flood  flows  occurring  at  a  reservoir  or  a  control 
point.  For  this  purpose,  flood  flows  are  considered  to  be  any 
flow  or  reservoir  release  in  excess  of  the  specified  maximum 
channel  capacity  or  outlet  capacity.  When  the  value  of  IDVSP, 
field  5  of  the  J1  card,  is  positive,  the  option  will  operate 
at  all  control  points  having  a  diversion  specified  in  the 
system  configuration.  The  flows  at  each  control  point  having 
a  diversion  are  checked  against  channel  capacity  or  outlet 
capacity  at  that  point,  ana  the  flow  quantities  in  excess  of 
capacity  are  added  to  the  diversion  at  that  point.  The  quan¬ 
tities  of  water  added  to  the  diversion  may  be  determined  from 
the  printed  routing  or  from  the  rearranged  diversion  data  for 
tne  control  point.  The  flow  spilled  through  the  diversion  may 
be  added  to  another  reservoir  or  control  point  in  the  system 
by  specifying  a  return  flow  diversion  at  the  second  control 
point.  This  feature  is  useful  in  studies  involving  inter¬ 
basin  transfer  and  storage  of  excess  flows  for  conservation 
purposes,  as  well  as  in  studies  involving  diversion  of  flood 
flows  through  bypasses  or  into  adjacent  river  channels. 
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EXHIBIT  1 


SPEC  I FYIMG  RESERVOIR  OPERATES  RULES 
USING  RESERVOIR  LEVELS 


HEC-3 

RESERVOIR  SYSTEM  ANALYSIS  FOR  CONSERVATION 


Release  priorities  between  reservoirs  are  an  important  reservoir 
operating  criterion  which  must  be  specified  for  most  system  operations. 
To  illustrate  the  technique  used  in  computer  program  HEC-3  and  HEC-5, 
the  following  example  has  been  prepared.  Assume  the  information  shewn 
below  in  Table  1  is  known  for  each  of  four  reservoirs  which  constitute 
a  reservoir  system.  Figure  1  shows  the  various  reservoir  levels  graphi¬ 
cally. 

TABLE  1 

Reservoir  Storage  Levels 

Reservoir  Storages,  Cumulative  (ac-ft) 


Number 

Top  In  .tive 

Top  Buffer 

Top  Cons 

Top  FC 

1 

1,000 

5,000 

50,000 

100,000 

2 

5,000 

10,000 

100,000 

200,000 

3 

10,000 

20,000 

150,000 

500,000 

4 

50,000 

100,000 

200,000 

700,000 

FIGURE  1 

Reservoir  Storage  Levels 


Flood  Control 
Storage 

Conservation 

Storage 


Exhibit  1 
Page  1  of  3 


It  is  desired  to  operate  this  system  according  to  the  following: 

1.  Release  all  flood  control  storage  to  maintain  the  same  deqree  of  risk. 

2.  Release  reservoir  1  conservation  storaqe  above  too  of  buffer, 
first. 

3.  'lext  release  reservoirs  2  and  3  conservation  storaqe  above  top 
of  buffer. 

4.  :iext  release  reservoir  4  conservation  storage  above  top  of 
buffer. 

5.  Release  conservation  storaqe  below  top  of  buffer  equally. 

To  specify  these  operatinq  criteria  in  1ITC-3  and  HfX-5,  each  storage 
level  in  each  reservoir  is  assigned  an  integer  number  from  1  to  a  maximum 
of  3.  The  number  of  levels  used  is  the  minimum  number  required  to  specify 
the  desired  operatinq  rules.  In  this  example,  six  levels  were  found  to 
be  necessary.  The  lowest  level,  level  1,  corresponds  to  the  top  of 
inactive  pool;  the  highest  level,  level  6,  corresponds  to  the  top  of 
flood  control  pool;  see  Table  2.  The  computer  program  makes  releases 
from  storage  between  the  highest  and  next  highest  level  until  the  water 
stored  between  these  levels  is  exhausted,  then  it  goes  to  the  next 
lower  level,  and  so  on  in  descending  order.  All  reservoirs  with  storaqe 
between  the  sane  successive  pair  of  levels  make  releases  where  possible 
to  maintain  the  same  degree  of  risk.  The  specific  criteria  depends  upon 
the  system  configuration. 

Levels  2  through  5,  in  this  example,  are  assigned  in  such  a  way 
that  the  system  operates  as  desired.  Since  operating  rule  1  desires 
that  all  reservoirs  release  from  flood  control  storage  equally,  by 
assigning  level  5  to  the  top  of  conservation  (bottom  of  flood  control) 
for  all  reservoirs  this  rule  is  achieved.  Operating  rule  2  desires 
that  all  conservation  storaqe  from  reservoir  1,  above  top  of  buffer,  be 
released  first,  by  assigning  level  4  to  the  top  of  buffer  for  reservoir 
1,  and  top  of  conservation  for  all  other  reservoirs,  this  rule  is  achieved. 

This  limits  the  available  storage  between  levels  4  and  5  to  the  conserva¬ 
tion  storage  in  reservoir  1,  thus  it  will  be  exhausted  before  water  is 
released  below  level  4.  Operatinq  rule  3  is  achieved  in  a  simmlar  manner, 
by  assigning  level  3  to  the  top  of  buffer  for  reservoirs  2  and  3  and  to 
the  top  of  conservation  for  reservoir  4.  Conservation  storage  volume  is 
provided  between  levels  3  and  4  for  reservoirs  2  and  3,  but  not  for 
reservoirs  1  and  4.  Lastly,  level  2  is  assigned  to  the  ton  of  buffer 
for  all  reservoirs.  This  meets  rule  4  since  reservoir  4  is  the  only 
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reservoir  with  storage  volume  between  levels  2  and  3.  Bel e  the  top  of 
buffer  all  reservoirs  are  to  release  equally.  This  is  achie/ed  since 
level  2  for  all  reservoirs  is  the  top  of  buffer. 


TABLE  2 

Assigned  Storage  Levels 


Level 

G 

5 

4 

3 

2 

1 


Res  1 

Res  2 

100,000 

200,000 

50,000 

100,000 

5,000 

100,000 

5,000 

10,000 

5,000 

10,003 

1,000 

5,000 

Res  3 

Res  4 

500,000 

700,000 

150,000 

200,000 

150,000 

200,000 

20,000 

200,000 

20,000 

100,000 

10,000 

50,000 

To  summarize,  Figure  2  shows  the  level  numbers  assigned  to  each 
reservoir  level  for  each  reservoir.  These  numbers  and  corresponding 
reservoir  storage  volumes  arc  specified  as  input  on  the  RL  card, 
uuring  simulation  the  system  operates  as  follows:  any  water  stored 
between  levels  5  and  6  is  released  from  each  reservoir;  when  the  water 
stored  between  levels  b  and  6  has  all  been  released,  water  between  levels 
4  and  b  is  released  -  in  this  example  only  reservoir  1  has  a  storage 
volume  between  these  levels;  v/hen  the  volume  stored  between  4  and  5  is 
exhausted,  releases  are  made  from  storage  between  levels  3  and  4,  this 
means  from  reservoirs  2  and  3;  next  storage  between  levels  2  and  3  is 
exhausted,  hence,  releases  are  made  from  reservoir  4;  and  lastly  storage 
betv/een  levels  1  and  2  is  released.  Tiiis  technique  for  specifying  reser¬ 
voir  operating  rules  has  proved  to  be  an  effective  way  to  handle  most 
operating  criteria. 


Level 
Top  of 

Flood  Control 

Top  of 
Conservation 

Top  of 
Buffer 


figure:  2 

Reservoir  System  Priority  of  Operation 
Res  1  ties  2  Res  3 


2,3,4 


4,5 


2,3 


4,5 


2,3 


Res  4 


3,4,5 


Top  of 
Inactive 


1 


1 


1 
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EXHIBIT  2 


TEST  DATA  1  -  DESCRIPTION 


General 


These  test  data  Illustrate  the  use  of  this  program  In  simulating 
the  operation  of  a  two-reservoir  system  to  meet  downstream  flow  and 
diversion  requirements. 


C.P.  1 
Schoharie 
Reservoir 


Return  Flow 


C.P. 


2 


Hydrologic  Data 

Average  monthly  evaporation  was  obtained  for  the  basin  and  input  on  the 
J8  card.  The  monthly  value  was  applied  to  each  reservoir  by  specifying 
the  ratio  CEVAP  (R1  card,  field  1)  equal  to  1.0. 

Streamflow  information  was  available  at  only  one  gaging  station  (6)  in 
the  basin;  therefore,  it  was  necessary  to  use  drainage  area  ratios  to 
compute  the  local  (flow  below  upstream  reservoir  and  control  point) 
monthly  flows  at  each  control  point  by  use  of  the  LF  card. 
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Control  Point 

Ratio  to  Flow 
Station  6 

Remarks 

i 

1.330 

Inflow  to  Schoharie  Reservoir 

2 

0. 

Receives  diversion  from  CP  No.  1 
no  local  flow. 

3 

1.09 

Local  flow  between  Schoharie  and 
Ashokan  Reservoirs. 

4 

0. 

Receives  diversion  from  CP  No.  3 
no  local  flow. 

5 

0. 

No  local  flow. 

Flow  Requirements  and  Constraints 

The  following  table  shows  the  flow  requirements  and  constraints  by  con¬ 
trol  point: 


Control  Point 


1 

2 

3 

4 

5 

Diversion  Requirement 
(00V;  ID  card,  field  1) 

63 

* 

52 

* 

0 

Minimum  desired  flow 
(qn;i;  ID  card,  field  2) 

0 

0 

n 

0 

** 

Minimum  required  flow 
((M2;  ID  card,  field  3) 

0 

0 

0 

0 

0 

Maximum  Permissible  Flow 
(QI1XX;  ID  card,  field  4) 

928 

99999*** 

958 

99999 

958 

*Jhe  diversion  is  actually  a  return  flow  and  is  indicated  on  the  DV 
card.  In  both  these  cases,  the  return  flow  is  100  percent  of  the 
diversion. 

**The  minimum  desired  flow  at  CP  No.  5  varied  by  month;  therefore,  a 
QD  card  was  used  for  input. 

***There  is  no  actual  maximum  flow  constraint,  so  a  large  number  was 
used. 


Exhibit  2 
Page  2  of  51 


Reservoir  Data 


The  reservoir  storage  has  been  specified  by  four  levels  (Nl;  J1  card, 
field  3).  The  first  level  is  the  minimum  pool,  the  second  is  the  top 
of  the  buffer  zone,  the  third  the  top  of  the  conservation  storage,  and 
fourth  the  top  of  the  flood  control  pool.  (See  Exhibit  1  for  a  further 
description  of  levels.)  There  is  no  buffer  storage  or  flood  control 
storage  in  this  test,  but  a  minimum  of  four  levels  must  be  specified. 

Reservoir  Storage 
Schoharie  Ashokan 


Initial  Capacity 

(ST0R1 ;  R1  card,  field  2) 

64,166 

339,016 

Top  Flood  Control  Pool 
(RL  card.  Level  4) 

66,000 

393,000 

Top  Conservation  Pool 
(RL  card.  Level  3) 

66,000 

393,000 

Top  Buffer  Storage 
(RL  card.  Level  2) 

6,140 

6,140 

Minimum  Pool 
(RL  card.  Level  1) 

6,140 

6,140 
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TEST  DATA  -  INPUT 


Y1  TEST  DATA  l 

T2  RESERVOIR  SYSTEM  ANALYSIS 

T3  .tIJNF.  J97« 

,11  5  1928  <10  0  0  1  0  0 

.14  3 

,15  IP  10  , 

.18  1,  1 ,  1.  0  0  t,  ?.  2.  3«  3» 

.18  2.  ?. 

P.P  1  3  0 

TO  S3  0  0  928  SCHOHARIE  RES. 

IF  1  6  1.33 

Rl  1.  6416*.  0  0 

RL  1  l  -1  10  614 

RL  3  \  »i  10^0  66 

RS  0  123  1070  3530  6140  9660  21200  36800  55200  66000.1 

RA  0  20  80  190  300  440  690  850  1000  1145 

RO  9?8  9?o  928  92$  928  928  928  928  928  92ft 

RE  980  1000  1020  Ifl40  1050  1060  1080  IlOO  1120  1130 

OP  ?  3  0 

TO  0  0  0  99999  00WN3TREAM 

l.P  1  .6  0 

nv  i  »i 

CP  3  5  0 

TD  5?  0  0  958  ASHQKAN  RES. 

l.F  1  6  1.09 

Rt  1  339016  0  0 

RL  1  3  *1  1  6140 

RL  3  3  «1  1000  393- 

RS  0  i 2  3  0  6140  15300  55200  138000  254000393000.1 
RA  0  150  338  1343  3312  4983  6671  8425 

RO  960  960  960  960  960  960  960  960 

RE  404  470  496  510  530  550  570  590 

CP  4  5  0 

TO  0  0  0  99999  DOWNSTREAM 

l.F  1  6  0 

DV  3 

CP  5  -1  0 

TD  0  0  0  958  KEN8IC0  INFLOW 

QD  59?  575  575  551  S5 1  530  534  530  580  643 

OD  625  615 

FD  „ 

TN  628  1060  1527  15<i6  272  545  578  1031  10?0  924  708  343  22« 

TN  629  63  98  1 1  ]  343  146  t?8i  1797  887  ?Sl  84  18  «7 

TN  67o  b?b  557  526  519  371  906  575  295  502  63  29  29 

TN  671  20  71  75  49  SO  365  1805  917  6«2  454  91  55 

TN  67?  ?!3  37  184  697  47).  389  1391  404  264  95  28  14 

ER 
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TEST  DATA  1 

RESERVOIR  system  analysis 

JUNE  1974 
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EXHIBIT  2 


TEST  DATA  2  -  DESCRIPTION 


General 

This  test  problem  illustrates  the  input  for  a  reservoir  system  that 
includes  hydroelectric  power  as  one  of  the  project  purposes.  The  system 
is  comprised  of  three  reservoirs  and  two  powerplants  »  one  each  at 
Reservoir  A  and  at  Reservoir  B  (see  schematic).  There  are  four  other 
control  points.  One  of  the  control  points  (CP  No.  2)  is  a  dummy  to 
show  that  it  may  be  necessary  to  add  such  points  occasionally  to  per¬ 
form  some  other  operation,  such  as  to  make  a  second  diversion.  Two 
years  of  monthly  flows  are  used  for  the  test  of  the  system  simulation. 


C.P.  4  /> 

Reservoir  C  /  4 


!  C.P.  1 
A  Reservoir  A 
/ 1  \  (Powerplant) 


C.P.  2 


(Dummy) 


A  C.P.  3 

j  Reservoir  q  (Powerplant) 


Diversion 


Return  Flow 


C.P.  5  £; 


C.P.  6  0 


C.P.  7 


Hydrologic  Data 

Average  monthly  evaporation  data  over  the  system  area  for  the  2-year 
period  was  obtained  and  input  by  the  J8  card. 
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The  following  ratios  were  used  to  derive  evaporation  at  each  reservoir 
site. 

Ratio 


Reservoir  A 

.9 

Reservoir  B 

1.0 

Reservoir  C 

1.0 

Streamflow  data  were  available  at  four  stations  (1,  3,  4,  5)  during 
the  period  to  be  simulated.  The  streamflow  at  the  other  sites  were 
computed  as  ratios  of  these  stations. 


CP  No.  2  0.  times  flow  at  Station  No.  1  (no  local  flow). 

CP  No.  3  Station  No.  3  minus  Station  No.  1  (to  obtain  local 

flow). 

CP  No.  5  Station  No.  5  minus  Station  No.  3  minus  Station 
No.  4 

CP  No.  6  Increase  In  local  flow  equal  to  flow  at  Station  No.  1 

CP  No.  7  Increase  in  local  flow  equal  to  flow  at  Station  No.  4 


Flow  Requirements  and  Constraints 


The  following  table  shows  the  demands  and  flow  constraints  by  control 
point. 


Control  Point 


1 

2 

3 

4 

5 

6 

7 

Diversion  Requirement 
(QDV;  ID  card,  field  1) 

0 

0 

1000 

0 

*★ 

0 

0 

Minimum  desired  flow 
(QMN;  ID  card,  field  2) 

0 

0 

0 

100 

-1* 

0 

0 

Minimum  required  flow 
(QM2;  ID  card,  field  3) 

0 

0 

0 

0 

100 

0 

0 

Maximum  Permissible  Flow 
(QMXX;  ID  card,  field  4) 

99999*** 

99999 

99999 

99999 

5000 

99999 

99999 
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*  The  minimum  desired  flow  varies  by  month  and  Is  input  by  the  QD 
card. 

JAN  FEB  MAR  APR  MAY  JUN  JUL  AUG  SEP  OCT  NOV  DEC 

100  100  100  2000  4500  4500  4500  4500  4500  100  100  100 

**The  diversion  is  actually  a  return  flow  and  is  Indicated  on  the  DV 
card.  In  this  case  the  return  is  25  percent  of  the  diversion  made 
at  CP  No.  3. 

***If  there  is  no  actual  maximum  flow  constraint,  a  large  number  may 
input. 


Reservoir  Data 


The  reservoir  storage  has  been  subdivided  into  seven  levels  (NL;  J1 
c:rd,  field  3).  The  first  level  is  that  storage  capacity  below  which 
no  releases  will  be  made.  For  this  test  data  only  two  levels,  1  and  7, 
remained  constant  throughout  the  year.  The  operation  plan  called  for 
the  target  levels  to  vary  seasonally  to  account  for  changing  runoff 
potential.  (See  Exhibit  1  for  a  description  of  level  specification.) 


Initial  Capacity 
(ST0R1;  R1  card,  field  2) 

Minimum  Pool 
(R1  card.  Level  1) 

Top  Flood  Control  Pool 
(RL  card.  Level  7) 


Reservoir 

A 

B 

C 

156,000 

106,600 

10,000 

107,000 

106,600 

10,000 

356,000 

456,000 

125,000 

The  remaining  levels  varied  by  month  and  the  values  should  be  evident 
in  the  listing  of  input  cards  and  in  the  output  listing. 


Power  Requirements 

The  two  hydroelectric  plants  have  individual  site  energy  requirements 
as  well  as  a  system  energy  requirement  of  25,000,000  kilowatt-hours 
(J9  card).  The  maximum  plant  factor  for  power  generating  for  each 
project  to  contribute  to  system  power  load  is  0.5  (PFMAX;  PI  card, 
field  8).  The  at-slte  energy  requirement  at  each  project  Is  specified 
by  a  plant  factor  of  0.2  for  each  month  (PR  card). 
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EXHIBIT  2 


TEST  DATA  3  -  DESCRIPTION 


General 


The  reservoir  system  for  Test  Data  3  is  very  similar  to  that  of  Test 
2.  There  are  three  reservoirs,  including  two  with  powerplants,  and 
one  downstream  control  point.  The  primary  differences  are  a  reduction 
in  the  number  and  renumbering  of  the  control  points,  a  renumbering 
of  the  flow  stations,  and  the  addition  of  economic  data  by  use  of 
EC,  BN,  BP  and  BV  cards. 
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REMAINING  PCTENTIAl  BENEFITS  AT  CONTROL  POINTS 
FUNCTION 


EXHIBIT  3 


OUTPUT  DATA  DESCRIPTION 
HEC-3 

RESERVOIR  SYSTEM  ANALYSIS  FOR  CONSERVATION 


The  program  has  the  capability  of  printing  a  monthly  and  annual 
output,  summary  data,  and  rearranged  data.  The  summary  and  rearranged 
data  are  optional  and  must  be  requested  by  the  user  on  the  03  and  J4 
cards.  The  standard  output  includes  a  labeled  printout  of  input  data, 
monthly  reservoir  and  control  point  operational  data  arranged  by  year, 
system  power  summary,  average  values  of  simulation  data,  and  shortage 
and  frequency  data.  A  detailed  description  of  the  standard  output  is 
presented  below. 

a.  Printout  of  Input  Data 

Test  Data  2  of  exhibit  2  illustrates  the  standard  output  pro¬ 
vided  by  the  program.  Input  data  specified  on  the  job  cards  (J1-J9) 
are  printed  out  and  titled  first.  This  Is  followed  by  a  printout  of 
input  data  for  each  control  point  -  arranged  in  an  upstream  to  down¬ 
stream  sequence. 

b.  Monthly  Reservoir  Operation  Data  Arranged  by  Year 

The  purpose  of  the  program  is  to  simulate  the  operation  of  a 
reservoir  system  on  a  month  to  month  basis.  Beginning  with  the  first 
year  it  prints  out  the  simulation  results  for  each  month  and  each  con¬ 
trol  point.  This  is  repeated  successively  for  all  years  of  the  Simula 
tlon.  The  data  printed  out  is  defined  below. 

(1)  Annual  Input  Data 

ANNUAL  INPUT  DATA  FOR  1926 

** INFLOWS 

Input  Inflow  values  in  cfs  or  cubic  meters  per  second 
are  tabulated  by  control  point  and  period  for  the  particular  year. 

(2)  Control  Point  Identification 

3  RESERVOIR  B  LEAKAGE  0  SERVED  BY  1  3 
SERVING  3567 

LOCAL  DIVERSIONS  3 
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This  information  identifies  the  control  point  as  3  and 
Reservoir  B.  There  is  zero  leakage  specified  from  the  reservoir  and 
the  reservoir  is  served  by  reservoir  1  and  itself  and  serves  downstream 
control  points  3567. 

(3)  Flow  Data 

YR  1926  AVG  JAN  •••  -  Column  headings.  All 
output  flow  data  contain  yearly  average  values  followed  by  values  for 
each  month  in  cubic  meters  per  second,  or  user  specified  units. 

The  quantities  under  AVG  for  evaporation  and  power  are  annual  sums. 

LOC  FLOW  -  Average  local  inflow  to  the  control  point. 
Computed  according  to  the  rule  specified  on  the  LF  card. 

UNREG  -  Total  unregulated  (natural)  inflow  to  the  con¬ 
trol  point.  Equals  the  summation  of  all  local  flows  above  the  control 
point,  including  those  above  reservoirs,  (i.e.,  1150  +  1770  =  2920) 

INFLOW  -  Regulated  inflow  to  the  control  point.  Equals 
the  flow  released  from  upstream  reservoirs  plus  the  cumulative  local 
inflow  between  control  point  and  upstream  reservoirs,  (i.e.,  1395  + 
1770  =  3165) 


REQ  DIV  -  Magnitude  of  the  flow  required  to  be  diverted 
at  the  control  point  as  specified  on  the  ID  or  DV  cards. 

DIVERSN  -  Magnitude  of  the  flow  actually  diverted. 

SHORTGE  -  Difference  between  REQ  DIV  and  DIVERSN. 

(4)  Reservoir  Data 

EOP  STR  -  End  of  period  storage  in  the  reservoir  as  com¬ 
puted  during  the  simulation  (ac-ft  or  1000  cubic  meters). 

EOP  EL  -  End  of  period  reservoir  elevation  corresponding 
to  end  of  period  storage  EOP  STR  (ft  or  meters). 

EVAPn  -  Evaporation  occurring  during  the  period  (ac-ft 
or  1000  cubic  meters). 

REQ  PWR  -  at-site  energy  requirements  (1000  Kwh)  as 
specified  on  the  PR  card. 

SYS  1  -  Energy  requirement  (1000  Kwh)  for  power  system  1 
that  is  allocated  to  this  project.  This  value  changes  by  month  and 
year  depending  upon  the  project  capability  and  the  input  system  energy 
requirement  (J9  card). 
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POWER  -  Energy  (1000  Kwh)  generated  at  the  project. 

SHORTGE  -  The  shortage  of  energy  requirements  as  comDuted 
by  the  difference  between  REQ  PWP,  and  POWER. 

SYS  SRT  -  Difference  between  SYS  1  and  POWEP.  Represents 
the  system  power  shortage  allocated  to  this  project. 

CASE  -  The  first  diqit  (or  first  two  if  a  four  digit 
number)  indicates  the  control  point  number  which  is  controlling  the 
operation.  The  last  digits  specify  the  condition  which  is  controlling- 
1  =  minimum  flow  requirement,  2  =  power  requirement,  3  =  flood  control 
release.  For  example,  CASE  =  2101  indicates  at  control  point  21, 
minimum  flow  requirements  control. 

LEVEL  -  Indicates  the  end  of  period  reservoir  storaae 
level.  For  example,  2.63  indicates  that  63  percent  of  the  storage 
space  between  levels  2  and  3  is  occupied. 

(5)  Flow  Release  Data 

CSV  REL  -  Maanitude  of  the  flow  at  the  control  noint 
which  is  released  to  meet  conservation  requirements  downstream.  The 
regulated  flow  (RIV  FLOW)  may  be  qreater  than  this  value  because  of 
spillage. 


RIV  FLOW  -  Magnitude  of  the  regulated  river  flow  occur¬ 
ring  at  the  control  point. 

DES  FLOW  -  Minimum  desired  flow  at  the  control  point  as 
specified  on  the  QD  or  ID  cards.  Desired  flow  will  be  released  if 
reservoir  is  above  the  top  of  buffer  pool. 

MIN  FLOW  -  Minimum  required  flow  at  the  control  point 
as  specified  on  the  QR  or  ID  cards.  The  minimum  required  flow  will 
be  released  if  the  reservoir  is  below  the  top  of  buffer. 

SHORTGE  -  Magnitude  by  which  desired  or  required  flow 
is  not  met,  i.e.,  short.  Difference  between  DES  FLOW  and  RIV  FLW, 
or  MIN  FLOW  and  RIV  FLOW. 

c.  System  Power  Summary 

REQUIRD  -  The  system  energy  requirement  (1000  Kwh)  as 
specified  on  the  J9  card. 

USABLE  -  Total  energy  generated  (1000  Kwh)  based  upon 
plant  factor  for  the  system  (PFMAX  on  PI  card)  at  all  projects  in  t>" 
power  system.  Secondary  or  dump  enerqy  is  the  difference  between  Tr,!\ 
and  USABLE  energy. 
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TOTAL  -  The  total  energy  generated  at  the  powerplants 
in  the  system  based  on  individual  overload  ratios  (OVLOD  on  PI  card). 
Equals  the  summation  of  POWER  for  each  powerplant.  (1000  Kwh) 

SHORTGE  -  The  system  energy  shortage  computed  as  the 
difference  between  REQUIRD  and  USABLE  energy  but  not  less  than  0. 

d.  Average  Values  of  Data  fcr  Simulation  Period 

The  variables  printed  out  in  the  tabulation  correspond  to  the 
variables  with  the  same  name  described  in  the  previous  section.  The 
values  shown  are  the  average  value  of  the  variables  for  the  entire 
period  of  operation. 

e.  Shortage  and  Frequency  Data 

Following  the  printout  of  average  values  several  shortage 
indices  are  tabulated,  as  required: 

DIVERSION  SHORTAGE  INDEX 
POWER  SHORTAGE  INDEX 
POWER  SYSTEM  1  SHORTAGE  INDEX 
DES  FLOW  SHORTAGE  INDEX 
MIN  FLOW  SHORTAGE  INDEX 

Each  index  is  computed  by  summing  the  squares  of  the  annual 
shortage  and  multiplying  by  100/number  of  years  of  operation.  The 
annual  shortage  is  expressed  as  the  ratio  of  the  annual  shortage  divided 
by  the  annual  requirement. 

r,„.„T,„r  ninrv  .  100  !!  /ANNUAL  SHORTAGC  \  2 

SHORTAGE  INDEX  -  —  I  ANNUAL'  WTREMENTyl 

As  an  example,  consider  the  computation  of  the  diversion  shortage  index. 
The  following  data  is  computed  as  part  of  the  simulation  data: 


1926  1927 


Annual  diversion  shortage  64  0 

Annual  diversion  requirement  1000  1000 

Annual  shortage  as  a  ratio  .064  0 

Number  of  years  of  operation  2 

Diversion  shortage  index  =  ^p-  [(.064)^  +  (0)^]  *  .205 
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The  shortage  index  for  the  other  variables  are  computed  in  a  similar 
manner.  Basically,  the  index  is  a  measure  of  the  frequency  and 
magnitude  of  shortage.  An  index  of  1.0  could  occur  with  100  ten 
percent  annual  shortages  in  a  100-year  period  means  an  averaqe  annual 
shortage  of  10  percent.  An  index  of  1.0  could  occur  with  25  percent 
annual  shortages  in  a  100-year  period.  A  shortage  index  of  zero 
indicates  no  major  shortages  and  a  1.000  indicates  no  requirement 
for  that  demand. 

The  computer  program  outputs  another  type  of  shortage  summary  which 
for  each  control  point  and  type  of  shortage,  shows  the  number  of  short¬ 
ages,  and  maximum  value  of  the  shortage.  In  the  example  below  control 
point  3  experienced  3  monthly  shortages,  one  with  a  magnitude  of  410. 

SHORTAGES 

STA  NO  MAX 

1 

2 

3  3  410 

*  •  • 


Storage-frequency  data  for  the  period  of  operation  is  computed  and 
printed  out  for  each  reservoir  control  point.  As  shown  below  the  values 
are  shown  for  various  ranges  within  the  conservation  pool  and  frequency 
is  shown  by  counting  the  number  of  Januarys  or  Februarys  when  the  reser¬ 
voir  was  within  that  range  of  the  conservation  pool.  Thus,  during  the 
period  of  operation  at  the  end  of  one  January  the  reservoir  storage 
was  between  99-100  percent  of  full  conservation  storage  only  once  for 
January.  Likewise  for  February,  the  storage  was  between  99-100  percent 
of  full  conservation  only  twice.  The  conservation  pool  is  that  volume 
between  top  of  inactive  pool  (level  1)  and  the  bottom  of  flood  control 
pool. 


CONS  POOL 

99-100  PCT 
95-99  PCT 


JAN  FEB 

1  2 

0  0 
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EXHIBIT  4 
INPUT  DESCRIPTION 

HEC-3 

RESERVOIR  SYSTEM  ANALYSIS  FOR  CONSERVATION 


This  exhibit  contains  a  detailed  description  of  each  variable  on 
each  input  card.  Many  of  the  cards  shown  can  be  omitted  if  certain 
options  are  not  required.  The  summary  of  input  cards  at  the  end  of  this 
exhibit  shows  the  sequential  arrangement  of  cards. 

Variable  locations  for  each  input  card  are  shown  by  field  number. 

The  cards  are  normally  divided  into  ten  fields  of  eight  columns  each 
except  field  1.  Variables  occurring  in  field  1  may  normally  only  occupy 
card  columns  3-8  since  card  columns  1  and  2  (except  for  J6  card)  are 
reserved  for  the  required  identification  characters.  The  different 
values  a  variable  may  assume  and  the  conditions  for  each  are  described 
for  each  variable.  Some  variables  simply  indicate  whether  a  program 
option  is  to  be  used  or  not  by  using  the  numbers  -1,  0,  1.  Other 
variables  contain  numbers  which  express  the  variable  magnitude.  For 
these  a  +  sign  is  shown  in  the  description  under  "value"  and  the  numerical 
value  of  the  variable  is  entered  as  input.  Where  the  variable  value  is 
to  be  zero  the  variable  may  be  left  blank  since  a  blank  field  is  read 
as  zero. 

If  decimal  points  are  not  punched  in  the  data,  all  numbers  must  be 
right  justified  in  the  field.  Any  number  without  a  sign  is  considered 
positive. 


A.  Title  Cards 


Tl,  T2,  T3  Cards 

Job  title  cards.  Three  cards  required.  Both  alphabetic  and  numeric 
information  may  be  placed  on  these  cards.  Information  on  these  cards 
will  be  printed  out  as  job  title  on  the  first  page  of  the  output. 


**Required  cards 
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J1 


** 


B.  Job  Cards 


J1  Card  -  First  Job  Card 


Job  card  which  specifies  program  options  and  operation  priorities. 


Field 

1 

2 


Variable 

NYRS 

IYR 

NL 


Value  Description 

+  Number  of  years  in  routing. 

+  ‘lumber  of  first  year  in  routing  (1935, 

for  example). 

+  ilumber  of  target  storage  levels  at 

each  reservoir.  At  least  four  levels 
are  required.  Maximum  number  of  levels 
(limited  by  dimension)  is  eight.  Levels 
are  described  on  the  RL  card. 


4  ICONS  0  If  ICONS  is  zero  or  blank,  downstream 

conservation  releases  will  be  restricted 
to  channel  capacity  to  simulate  flood 
control  considerations  in  conservation 
studies.  This  is  the  normal  option  for 
conservation  studies. 


5 


IDVSP 


+  If  ICONS  is  positive,  conservation 

releases  are  not  restricted  by  down¬ 
stream  channel  capacities. 

0  If  IDVSP  is  zero  or  blank,  uncontrolled 

spill  will  be  released  to  the  river 
below  a  reservoir.  This  is  the  normal 

option. 

+  If  IDVSP  is  positive,  uncontrolled 

spills  will  be  added  to  diversion  if  one 
exists  at  the  reservoir.  See  Appendix 
II. 


6  IPUPR 


**Required  cards 
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0  If  IPUPR  is  zero  or  blank,  power  shortages 

will  not  be  declared  within  the  buffer 
zone  (between  levels  1  and  2).  This 
permits  power  production  to  share  the 
highest  priority  throughout  the  full 
conservation  pool. 

-1  If  IPWPR  is  -1,  power  shortages  are 

declared  when  the  reservoir  storage  is 
within  the  buffer  zone.  This  gives 
power  a  lower  priority  than  other  purposes 
served  by  water  from  the  buffer  storage. 


J1 


J1  Card  (continued) 

Field  Variable  Value 
7  IDVPR  0 


-1 


8  I  F  LOW  0 


+ 


9  JUPQI  0 


+ 


Descri ption 

If  IDVPR  is  zero  or  blank,  diversion 
shortages  for  diversions  from  a 
reservoir  will  not  be  declared  within 
the  buffer  zone.  This  permits  diversions 
to  share  the  highest  priority  throughout 
the  full  conservation  pool. 

If  IDVPR  is  -1,  diversion  shortages 
are  declared  when  the  reservoir  storage 
is  within  the  buffer  zone.  This  gives 
diversions  a  lower  priority  than  other 
purposes  served  by  water  from  the 
buffer  storage. 

Maximum  yield  will  not  be  computed 
for  any  control  point.  This  is  the 
normal  option  for  most  studies. 

Control  point  number  for  location 
where  maximum  yield  is  to  be  com¬ 
puted  by  iteration  process.  Maximum 
yield  can  be  computed  for  only  one 
control  point  location  per  run. 

See  Appendix  I. 

Local  inflows,  read  from  IN  cards  and 
computed  by  ratios  on  the  LF  card,  are 
cumulative  flows  and  are  for  areas 
upstream  of  the  control  point  and  down¬ 
stream  of  the  nearest  upstream  reservoirs. 

Calls  for  specifying  local  flows  (IN 
and  LF  cards)  as  incremental  inflows 
between  adjacent  control  points. 
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*  J2  Card  -  Constants  and  Input  and  Output  Units 

Job  card  specifying  units  of  input  data  and  output  data,  conversion 
constants,  /.nd  contingency  ratios.  If  omitted  default  values  in  parenthe¬ 
ses  will  be  assigned. 

Field  Variable  Value  Uescription 

1  CLOCL  0  Contingency  factor  of  1.0  is  assumed. 

0.0) 

+  Contingency  factor  for  adjusting 

local  flows  below  reservoirs  to  account 
for  forecast  uncertainty  or  other  con¬ 
tingencies  in  conservation  operation. 

Must  be  between  D.O  and  1.0.  (For 
example,  a  value  of  .35  for  CLOCL  will 
cause  all  local  flows  below  reservoirs 
to  be  temporarily  multiplied  by  .35  to 
account  for  a  15  percent  contingency 
in  conservation  forecasts  of  local  flow.) 

Contingency  factor  of  1.0  is  assumed. 

Contingency  factor  for  adjusting 
local  flows  below  reservoirs  to  account 
for  forecast  uncertainties  or  contin¬ 
gencies  that  affect  flood  control 
operation.  Must  be  equal  to  or  greater 
than  1.0.  (For  example,  a  value  of 
1.15  for  CFLOD  will  cause  all  local 
flows  below  reservoirs  to  be  temporarily 
multiplied  by  1.15  to  account  for  a 
15  percent  contingency  in  flood  control 
forecasts  of  local  flows.) 

If  IUillT  is  zero  or  blank,  output  data 
will  be  in  standard  flow  units  of  cfs 
(nw/sec  for  metric  system)  and  volume 

units  of  acre-feet  (thousand  cubic 
meters  for  metric  system).  Fields  7-10 
will  also  be  zero. 

+1  Allows  for  nonstandard  output  units  as 

specified  in  fields  7,  8,  0  and  10  of 
this  card.  Uata  for  all  four  fields 
must  be  specified. 

♦Optional  card 
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J2 


J2  Card  (continued) 

Field  Variabl e 

4  METRC 

(0) 


Value 

0 


+1 


5  CfISTI 

(1.0) 


0 


+ 


6 


CNSTO  0 

(1.0) 


Description 

If  METRO  is  zero  or  blank,  input  and 
output  will  be  in  English  units  (cfs 
and  acre-feet). 

Input  and  output  data  in  metric  units 
(m3/sec  and  thousand  cubic  meters). 

Inflow  rates  are  in  cfs  or  m-l/sec. 

(Ratio  CNSTI  is  assumed  1.) 

Ratio  to  convert  input  inflow  rates 
(card  IN)  from  nonstandard  to  standard 
units  (i.e.,  CNSTI  is  1.0  if  input 
inflow  data  is  in  cfs  or  cms  and  100.0 
if  input  inflow  data  is  in  hundred  cfs 
or  hundred  mfysec). 

Ratio  (preceded  by  a  minus  sign)  to 
convert  input  inflow  volumes  (card  IN) 
from  nonstandard  to  standard  units 
(i.e.,  CNSTI  is  -1.0  if  input  inflow 
data  are  in  acre-feet  or  thousand  cubic 
meters,  and  -1000  if  input  inflow  data 
are  in  thousand  acre-feet  or  million 
cubic  meters). 

Input  flow  rate  requirements  are  in 
cfs  or  m3/sec.  (CNST0  is  assumed  1.) 

Ratio  to  convert  input  flow  rate  require¬ 
ments  (cards  ID,  DV,  QD,  OR  and  QM)  from 
nonstandard  to  standard  units.  (See 
description  for  CNSTI,  above.) 

Ratio  to  convert  input  flow  volume 
requirements  (cards  ID,  DV,  QD,  QR  and 
QM)  from  nonstandard  to  standard  units. 
(See  description  for  CNSTI,  above.) 


Exhibit  4 
Page  5  of  41 


J2 


02  Card  (continued) 

Field  Variable 

7  CCFS 

(1.0) 


8  QUNIT 

(cfs) 


9  CACFT 

(1.0) 


10  VUNIT 


Value  Description 

0  Must  be  zero  or  blank  if  IUNIT  (field 

3)  is  zero  or  blank. 

+  Ratio  to  convert  output  flow  data  from 
standard  rate  (cfs  or  mVsec)  units  to 
nonstandard  rate  units. 

Ratio  to  convert  output  flow  data  from 
standard  rate  units  (cfs)  to  volume 
units  (acre-feet).  CCFS  is  -1.0  for  output 
in  acre-feet  and  -.001  for  thousands  of 
acre-feet. 

Alpha  Four-character  alphabetic  symbol  for 
output  headings  when  using  nonstandard 
fl ow  units.  Must  be  right-justified. 

(For  example,  KCFS  might  be  used  if 
output  units  are  to  be  in  thousands  cfs.) 

0  Must  be  zero  or  blank  if  IUNIT  (field  3) 

is  zero  or  blank. 

+  Ratio  to  convert  output  volume  data 

from  standard  (acre-feet  or  thousand 
cubic  meters)  units  to  nonstandard 
units. 

Alpha  Four-character  alphabetic  symbol  for 
output  headings  when  using  nonstandard 
volume  units. Must  be  right-justified. 
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*  J3  Card  -  Output  Options 

Job  card  which  permits  user  to  select  various  output  options  and  some 
program  options.  If  omitted,  default  values  in  parentheses  will  be 
assigned. 


Field 

1 


2 


3 


4 


Variable  Value 

IPRNT  0 

(0) 

-1 


IPRL  0 

(0) 


IPWKW  0 

(0) 


IUPDT 

(0) 


+ 

0 


+ 


Description 

If  IPRMT  is  zero  or  blank,  the  standard 
monthly  and  annual  output  is  obtained. 

If  IPRNTis  -1,  the  standard  monthly 
and  annual  output  is  suppressed.  Only 
summary  data  and  rearranged  data  (if 
selected)  is  printed  out. 

If  IPRL  is  zero  or  blank,  reservoir 
target  levels  are  printed  out  only 
once  at  the  beginning  of  the  output. 

This  is  all  that  is  normally  required. 

If  IPRL  is  positive,  reservoir  target 
levels  are  printed  out  for  each 
reservoir  each  year  to  facilitate 
checking  of  results.  This  causes  a 
substantial  increase  in  the  volume  of 
output  and  should  only  be  used  for 
short  runs  with  small  systems. 

If  IPWKW  is  zero  or  blank,  power  genera¬ 
tion  output  data  win  be  in  thousand 
kwh. 

If  IPWKW  is  positive,  power  generation 
output  data  will  be  in  kilowatts. 

If  IUPDT  is  zero  or  blank,  the  system 
data  will  not  be  updated  to  reflect 
changes  in  the  system  configuration. 

This  is  the  normal  option. 

If  IUPDT  is  positive,  the  system  data 
will  be  updated  at  the  end  of  NYRS  (J1 
card,  field  1).  To  use  this  option 
the  user  must  supply  a  complete  new 
set  of  input  data,  beginning  with  the 
T1  cards,  immediately  following  the 
last  data  card  for  the  first  NYRS  of 
.ata  while  reservoir  status  is  main¬ 
tained. 


♦Optional  card 
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J3  Card  (continued) 

Field  Variable 

5  IDGST 

(0) 


Value 

0 


+ 


6-10 


Description 

If  IDGST  is  zero  or  blank,  no  diagnostic 
or  intermediate  printout  is  obtained. 
This  is  the  normal  option. 

If  IDGST  is  positive,  intermediate 
diagnostic  printout  is  obtained  in 
addition  to  the  normal  output.  This 
option  should  only  be  used  when  attempt¬ 
ing  to  diagnose  the  cause  for  errors  or 
inconsistencies  in  study  results. 

Hot  used. 
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*  J4  Card  -  Output  Rearrangement 

Job  card  which  specifies  which  output  data  are  to  be  rearranged  and 
printed  after  the  normal  year  by  year  output.  Indicated  output  data  will 
not  be  rearranged  if  zero  or  blank  is  specified  in  the  appropriate  field. 
Rearranges  first  50  years  only.  (Restricted  by  dimension.)  If  this  card 
is  omitted,  output  data  will  not  be  rearranged.  For  the  first  nine  fields, 
if  the  specified  value  is: 

T_  -  Output  data  will  be  rearranged  by  control  points  (i.e.,  all 
output  values  for  the  item  will  be  summarized  for  all  years  at  each 
control  point); 

2-  Output  data  will  be  rearranged  by  years  (i.e.,  all  output 
values  for  the  item  will  be  summarized  for  all  control  points  in  each 
year); 

2-  Output  data  for  the  item  will  be  summarized  both  by  control 
point  and  by  year. 

In  the  tenth  field,  if  the  specified  value  is: 

1  -  Reservoir  data  will  be  rearranged  for  all  reservoirs  and  all 
years; 

2  -  Reservoir  data  will  be  rearranged  only  for  those  reservoirs  with 


power 

plants. 

Field 

Variable 

Value 

Description 

1 

IRG(l) 

See  above. 

Rearranges  unregulated  flows. 

2 

I RG ( 2 ) 

II 

Rearranges  river  flows. 

3 

I RG ( 3 ) 

II 

Rearranges  diversions. 

4 

IRG (4 ) 

II 

Rearranges  diversion  shortages. 

5 

I  RG ( 5 ) 

II 

Rearranges  desired  flow  shortages. 

5 

IRG ( 6 ) 

II 

Rearranges  required  minimum  flow  shortaqes. 

7 

I  RG ( 7 ) 

II 

Rearranges  end-of-period  storages. 

n 

u 

IRG(3) 

II 

Rearranges  change  of  storage  at  end- 
of-period. 

9 

IRG(9) 

II 

Rearranges  end-of-period  elevation. 

10 

IRG (10) 

II 

Rearranges  reservoir  data  (storage, 
elevation,  inflow,  outflow,  evapora¬ 
tion  and  power  generation). 

♦Optional  card 
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*  J5  Card  -  Routing  Time  Interval 

Job  card  which  specifies  the  time  intervals  to  be  used  in  the  routing. 
If  omitted,  default  values  in  parentheses  will  be  assigned. 


Field 

Variable 

Value 

Description 

1 

NPER 

(12) 

+ 

Number  of  routing  periods  per  year. 
Normal  number  is  12  for  conservation 
studies.  Periods  do  not  have  to  be 
of  equal  length  in  conservation  studies 
and  do  not  necessarily  coincide  with 
calendar  months.  Output  format  is 
designed  for  14  or  less  periods  per 
year. 

2 

IPERA 

(1) 

+ 

The  identification  number  of  the 
first  routing  period  in  each  year  (i.e., 
IPERA  is  1  if  routing  is  done  and  data 
supplied  on  a  calendar-year  basis; 

IPERA  is  10  if  routing  is  done  and 
data  supplied  on  a  water-year  basis). 

*  J6  Card  -  Period  flames  (No  identification  in  columns  1  and  2) 


Job  cards  which  identify  the  name  of  each  period.  Each  period  name 
may  be  up  to  eight  characters  in  length.  Both  alphabetic  and  numeric 
characters  are  permitted.  Period  names  should  be  centered  within  the 
eight-column  fields  to  improve  appearance  of  output.  Mot  required  if 
periods  are  based  on  calendar  months  (default  values). 


Field 

Variable 

Value 

Description 

1 

APERD(l) 

(JAN) 

Alpha 

Period  name  for  first  period  (example: 
JAN). 

2 

APERD(2) 

(FEB) 

Alpha 

Period  name  for  second  period  (example: 
FEB). 

Continue  supplying  period  names  until  a  name  has  been  supplied  for  each 
of  the  MPER  periods  (normally  2  cards).  The  name  in  the  first  field  must 
be  the  name  corresponding  to  period  number  IPERA  (J5  card,  field  2). 


♦Optional  card 
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*  J7  Card  -  Length  of  Periods  (Supply  or  omit  both  J6  and  J7  cards.) 


J7 

J8 


Job  cards  which  specify  the  number  of  days  in  each  period.  !lnt 
required  if  periods  are  based  on  calendar  months  (default  values  are 
number  of  days  in  calendar  month). 


Field 

Variable 

Value 

Description 

1 

NDAYS(l) 

(31) 

+ 

Number  of  days  in  first 

period. 

2 

flDAYS  (2) 
(23) 

+ 

Number  of  days  in  second 

period. 

Continue  supplying  number  of  days  in  each  period  until  NPER  values 
have  been  supplied  (normally  2  cards).  The  number  of  days  in  the  first 
field  must  be  the  number  of  days  in  period  number  IPERA  (J5  card,  field 
2). 

*  J3  Card  -  System  Evaporation 

This  card  specifies  index  evaporation  rate  for  the  entire  system 
for  each  period.  If  MPER  (05  card,  field  1)  is  greater  than  10,  two 
cards  must  be  used  to  describe  the  evaporation.  If  omitted,  card  YE  or 
EV  must  be  given. 

Field  Variable  Value  Description 

1-12  EVAPO  +  Net  index  evaporation  rate  in  inches 

"[or  mm  if  METRC  is  positive).  Specify 
MPER  (J5  card,  field  1)  values  in 
successive  order,  one  value  per  field. 
The  first  value  must  be  the  value  for 
period  number  IPERA  (J5  card,  field  2). 
Usually  computed  as  the  difference 
between  evaporation  and  rainfall.  Must 
be  supplied  as  positive  when  evapora¬ 
tion  exceeds  rainfall  and  negative  when 
rainfall  exceeds  evaporation. 


*0ptional  card 


Exhibit  4 
Page  11  of  41 


J9 


*  J9  Card  -  System  Power 

These  cards  specify  system  enerqy  requirements  for  each  power  system 
for  each  period.  Omit  if  there  is  no  system  power  operation.  One  set 
of  J9  cards  is  required  for  each  power  system  (maximum  of  two  systems). 

If  1PER  (J5  card,  field  1)  is  qreater  than  10,  two  cards  must  be  used  to 
describe  each  power  system. 

Field  Variable  Value  Descri ption 

1-10  PilRS  +  System  enerqy  requirements  in  thousand  of 

kwh.  Specify  1PER  (J5  card,  field  1) 
values  in  successive  order,  one  value 
per  field.  The  first  value  must  be 
the  value  for  period  number  IPERA 
(J5  card,  field  2).  The  second  power 
system  is  started  in  the  first  field 
of  a  new  J9  card.  Two  cards  are  normally 
required  for  each  power  system. 


System  Specification  Cards 


System  specification  cards  are  used  to  specify  the  configuration  of 
the  water  resource  system  and  the  constraints  and  objectives  for  operation 
of  each  component  of  the  system.  The  term  "control  point"  is  used  to 
describe  any  location  within  a  system  where  information  is  needed.  A 
set  of  system  specification  cards  is  required  for  each  control  point. 

Each  set  of  system  specification  cards  is  composed  of  three  subsets. 

The  first  subset  (cards  CP-9M)  is  required  for  all  control  points.  The 
second  subset  (cards  Rl-RE)  is  only  required  when  there  is  a  reservoir 
located  at  the  control  point.  The  third  subset  (cards  PI -PE)  is  only 
required  when  there  is  a  power  installation  at  the  control  point.  The 
sets  of  system  specification  cards  must  be  arranged  in  downstream  order 
beginning  with  the  most  upstream  control  point  and  proceeding  until  a 
confluence  is  reached.  At  each  confluence,  all  control  points  above 
that  confluence  must  be  entered  before  proceeding  to  control  points  below 
the  confluence. 


*0ptional  card 
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C.  Control  Point  Subset  (Cards  CP-OM) 

**  CP  Card  -  Control  Point  Specification 

The  CP  card  specifies  the  control  point  number,  the  relationship  of 
the  control  point  to  the  next  downstream  control  point,  and  the  physical 
components  that  exist  at  the  control  point.  It  is  required  for  each 
control  point. 


Field  Variable  Value 


Description 


1  II  +  Control  point  number,  ilust  be  an  intoner 

between  1  and  40  (limited  by  dimension)  or 
between  1  &  30  if  a  reservoir.  Control  point 
numbers  do  not  have  to  be  in  numerical  order. 


2  HONST  + 

-1 

3  IPR’I  0 

-1 


4-10 


Control  point  number  of  the  next  downstream 
control  point. 

Use  -1  when  !i  is  the  most  downstream 
control  point. 

Zero  or  blank  indicates  that  standard 
output  printout  is  desired  for  this 
control  point. 

Value  of  -1  indicates  that  standard  output 
printout  for  this  control  point  should  be 
suppressed.  If  -1  is  specified,  only 
summary  data  will  be  princ  d  for  tin's 
control  point. 

Not  used. 


**Required  card 
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ID 


**  ID  Card  -  Control  Point  Identification 


The  ID  card  is  required  for  each  control  point.  It  specifies 
diversion  and  minimum  flow  requirements,  maximum  flow  capability, 
and  the  control  point  name. 


Field  Variable  Value 


Description 


1 


2 


Q 


.  ii 


1 


3 


+  Diversion  requirements  at  this  control 

point.  This  value  will  be  used  for  all 
routing  periods.  Requirements  that 
vary  from  period  to  period  are  specified 
on  the  DV  card. 

+  ilinimum  desired  flow  at  this  control 

point.  This  is  the  flow  requirement 
which  will  be  met  at  all  times  when 
the  storage  level  in  upstream  reservoirs 
exceeds  the  top  of  the  buffer  zone 
(see  RL  card).  The  purpose  of  this 
constraint  is  to  permit  a  flow  require¬ 
ment  somewhat  higher  than  the  absolute 
minimum  to  be  used  when  reservoir  stor¬ 
age  levels  are  not  critically  low.  If 
Qll.T  is  specified  as  a  positive  value 
in  this  field,  that  positive  value  will 
be  used  for  all  routing  periods,  Minimum 
desired  flows  that  vary  from  period  to 
period  within  a  year  are  specified  on 
the  QP  card. 

+  Minimum  required  flow  at  this  control 

point.  Reservoir  releases  will  be 
made  to  maintain  this  flow  requirement 
as  long  as  there  is  any  useable  storage 
(between  levels  1  and  2J  in  upstream 
reservoirs.  Minimum  required  flows  at 
this  control  point  that  vary  from  period 
to  period  within  a  year  are  specified  on 
the  QR  card. 


^Standard  units  (cfs  or  m^/seu)  unless  nonstandard  units  have  been  specified 
by  C'ISTO  (J2.G). 

**Required  card 
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ID 


ID  Card  (continued) 

Field  Variable  Value 
4  QMXX1  + 


5-8  CPT  Alpha 


9-10 


Description 

Maximum  permissible  flow  at  this  control 
point.  Usually  the  nondamaging  channel 
capacity  is  specified.  Reservoir  releases 
that  would  cause  streamflow  at  this  point 
to  exceed  this  value  will  not  be  permitted 
until  reservoir  storage  exceeds  the  top 
of  the  flood  control  pool  (the  highest 
level  from  field  3  of  J1  card).  If 
maximum  permissible  flows  at  this  con¬ 
trol  point  vary  from  period  to  period, 
they  are  specified  on  the  QM  card. 

Control  point  identification  or  name. 

Both  alphabetic  and  numeric  characters 
can  be  used.  It  is  not  necessary  to 
include  the  control  point  number  in 
the  station  identification.  Limit  is 
32  characters  including  blanks. 

Not  used. 


1  Q 

Standard  units  (cfs  or  nr/sec)  unless  nonstandard  units  have  been 
specified  by  CNSTO  (J2.6). 
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*  LF  Card  -  Local  Flow  Specification 

Tin's  card  specifies  the  identification  number  of  the  flow  data  (IN 
cards)  used  to  compute  either  cumulative  (JUPQI  =  0,  on  J1  card)  or 
incremental  (JUPQI  =  1)  local  flows  for  this  control  point  and  the 
ratios  used  in  the  computation.  If  NFLM  is  greater  than  4,  two  or 
more  cards  will  be  required.  Omit  if  there  is  no  computation  required  to 
obtain  local  flow.  This  can  occur  if:  (1)  IN  cards  are  provided  for 
this  control  point  that  represent  flows  between  this  control  point 
and  control  points  immediately  upstream  (J'JPQI  =  1);  or  (2)  IN  cards  are 
provided  for  this  control  point  that  represent  flows  between  this  control 
point  and  all  reservoi rs  immediately  upstream  (JUPQI  =  0).  Omission  of 
this  card  requires  the  flow  data  (IN  card)  to  have  the  same  identification 
as  this  control  point  (CP  card,  field  1) 

Field  Variable  Value  Jescri ption 

1  NFL'.J  +  Number  of  flow  locations  involved  in 

computing  local  flow,  either  cumulative 
or  incremental  (based  on  JUPQI),  for 
this  control  point.  This  will  be  positive 
if:  (1)  no  flows  are  provided  as  input 
on  IN  cards  for  this  control  point  and 
cumulative  or  incremental  local  flow  is 
to  be  calculated  by  a  ratio  (such  as 
drainage  area  ratio)  times  some  single 
input  flow  data  location  (NFLU  =  1 )  or 
some  combination  of  multiple  input  flow 
data  locations  (NFL!.'  >1);  or  (2)  if 
flows  provided  as  input  on  IN  cards  for 
this  control  point,  are  total  flows  at 
this  control  point  rather  than  incremental 
or  cumulative  local  flows.  The  summation 
of  all  HFLW  for  all  control  points  must 
not  exceed  90  (dimension  limit). 

2  :!Q  +  Identification  number  of  first  flow 

station  involved  in  computing  local  flows 
for  this  control  point  (must  equal  an  M 
on  IN  cards).  Identification  numbers  for 
flow  stations  do  not  have  to  correspond 
to  control  point  numbers,  but  they  must 
be  integers  and  less  than  40.  See  descrip¬ 
tion  for  variable  M  (IN  card,  field  1). 


♦Optional  card 
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*LF  Card  (continued) 

Field  Variable  Value 
3  RTIO  + 


4-9 


10  :IQ(5)  + 


Description 

Ratio  by  v/liich  flow  data  for  station  MO 
in  preceding  field  is  to  be  multiplied 
to  obtain  local  flow  at  this  control 
point.  Negative  value  indicates  flow 
at  station  MQ  should  be  multiplied  by 
RTIO  and  then  subtracted  from  other 
flows  involved  in  the  computation. 

Repeat  values  of  MQ  and  RTIO  until  ’’FLU 
pairs  have  been  specified.  For  example, 
to  calculate  cumulative  or  incremental 
local  flows  between  a  control  point  and 
two  immediately  upstream  reservoirs  where 
the  input  flow  for  the  control  point  is 
the  total  f  1  ox/  and  where  the  flow  identi¬ 
fication  number  for  the  control  point  is 
7,  and  the  flow  identification  numbers 
for  the  two  upstream  reservoirs  are  2 
and  5,  the  input  values  would  be  7,  1.0; 

2,  -1.0;  5,  -1  in  fields  2-7,  respectively. 

Every  fifth  pair  of  and  RTIO  will  be 
split  between  the  tenth  field  of  one 
card  and  first  field  of  the  next  card. 
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*  EC  Card  -  Hydro! oni c  Parameters  Used  in  Economic  Evaluation 

This  card  identifies  the  hydrologic  parameters  at  this  control 
point  that  will  he  used  in  economic  evaluation.  If  omitted,  economic 
evaluation  will  not  be  made  at  this  control  point. 


field  Variable  Value 


1-0  IE  0 

1 


2 


3 

4 


Description 

Ho  economic  function  for  this  control 
point. 

Economic  evaluation  based  on  river 
flow  and  unregulated  flow  in  cfs  (or 
n3/sec)  at  the  control  point. 

Economic  evaluation  based  on  reservoir 
storage  in  acre-feet  (or  1000  m’)  at 
this  control  point. 

Economic  evaluation  based  on  energy 
generation  in  kwh  at  this  control  point. 

Economic  evaluation  based  on  diversion 
flow  in  cfs  (or  m3/sec)  at  this  control 
point. 


4  s  many  as  eight  benefit  functions  nay  be  used  in  the  economic  evaluation. 
Each  of  the  eight  fields  on  the  EC  card  represents  one  benefit  function. 

For  example,  in  an  economic  evaluation  of  power  production  on  the  basis  of 
energy  generation,  and  recreation  on  the  basis  of  reservoir  storage  and  where 
energy  generation  is  selected  as  benefit  function  1  and  recreation  as  benefit 
function  2,  the  value  specified  in  field  1  for  each  control  point  with  a 
power  plant  to  be  evaluated  would  be  3  and  the  value  specified  in  field 
2  for  each  control  point  with  a  recreation  benefit  would  be  2.  The  order 
ciiosen  (power  first  and  recreation  second)  must  be  maintained  for  all 
control  points  and  must  be  followed  on  the  P/I,  PP  and  PV  cards.  Zero  or 
blanks  must  be  specified  for  all  fields  not  being  used  for  a  particular 
control  point. 


Field 

-MO  -iot  used. 


*Ontional  card 
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*  SV  Card  -  Locations  not  Served  by  Reservoir 


sv 

DV 


This  card  specifies  the  number  and  Identity  (control  point  number)  of 
the  downstream  locations  not  served  by  a  reservoir  at  this  control  point. 
If  NTSRV  on  this  card  Is  greater  than  9,  two  cards  will  be  required. 


Field 

Variable 

Value 

Description 

1 

NTSRV 

+ 

Number  of  downstream  control  points  that 
should  not  be  served  by  water  stored  In 
reservoir  at  this  location.  This  enables 

user  to  specify  whether  or  not  water  may 
be  withdrawn  from  this  reservoir  to  meet 
downstream  demands  at  any  point. 

2-10 

ITSRV 

+ 

Identification  numbers  of  downstream  con- 

trol  points  where  water  requirements  will 
not  be  served  by  storage  In  reservoir  at 
this  control  point  number  (from  last  card 
CP,  field  1).  Provide  NTSRV  values,  one 
value  per  field. 


DV  Card  -  Varying  Diversion  Requirements 


This  card  specifies  diversion  requirements  at  this  control  point 
that  vary  from  period  to  period  and  normally  requires  two  cards.  Return 
flows  can  be  specified  by  entering  the  control  point  number  of  the  upstream 
diversion  in  field  1  and  a  negative  value  for  the  return  flow  ratio  in 
field  2.  For  example,  a  value  of  26  in  field  1  and  a  value  of  -.35  in 
field  2  would  indicate  a  return  flow  at  this  control  point  which  is  35 
percent  of  the  flow  diverted  at  control  point  26.  Return  flows  can  only 
be  calculated  as  a  function  of  diversions  at  one  upstream  control  point. 
Either  QDV  ( ID . 1 )  or  DV  card(s)  must  be  provided  even  if  YD  cards  supplied. 
Dimensioned  for  25  diversions. 


Field  Variable  Value 


Description 


1  QDIV  +  Diversion  requirements  for  first  period 

in  standard  flow  units  (cfs  or  nvVsec) 
unless  nonstandard  flow  units  have  been 
specified  by  CNSTO  (J2  card,  field  6). 

If  field  2  is  negative,  this  is  the 
control  point  number  as  described  above. 

2  QDIV  +  If  positive,  di.arsion  requirements  for 

second  period;  NPER  (J5  card,  field  1) 
values  must  be  provided. 


If  negative,  ratio  to  compute  return 
flow  as  described  above. 


♦Optional  card 
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PS  Card  -  Diversion  Specifications 


Field 

Variable 

Value 

Description 

1 

IDIVF(M) 

Specifies  parameter  to  base  diversion  on. 

1 

Diversion  based  on  natural  flow. 

2 

Diversion  based  on  regulated  flow. 

3 

Diversion  based  on  reservoir  storage. 

2 

NDIV(M) 

+ 

Number  of  values  to  follow  on  each  DF  and 

DP  cards. 

3 

IDCPT(M) 

+ 

Control  point  number  where  parameter  is  to 
compute  diversion.  Used  where  diversion  is 
a  function  of  storage  or  flow  at  some  other 
location.  May  be  left  blank  if  at  this 
control  point. 

4 

IDSHT(M) 

0 

Diversion  shortages  will  be  computed. 

1 

Diversion  shortages  set  to  zero  at  this 
control  point. 

DF  Card 

-  Diversion  Rate 

Field 

Variable 

Value 

Description 

1 

DFUNCT(1,M) 

+ 

Diversion  rate  to  be  made  at  corresponding 
status  of  selected  parameter  on  DP  card. 
Diversion  will  be  less  than  or  equal  to 
diversion  specified  by  QDV  (ID  card,  field 
1)  or  by  DV  cards. 

2 

DFUNC(2,M) 

+ 

Second  diversion  rate. 

Provide  NDIVF(DS-2) 

values,  dimensioned  for  20  values. 

DP  Card 

-  Parameter  Status 

Field 

Variable 

Value 

Description 

1 

DPARA(1,M) 

*!* 

Status  of  oarampter  at  ,Jhich  corresoondinq 
diver* ion  rate  will  be  made  corresponding 
to  DF  card.  Each  successive  value  must  be 
larger  than  the  previous  one. 

2 

DPARA(2,M) 

+ 

Second  parameter  status. 

♦Optional  cards;  however,  if  DS  card  is  used 
OF  and  DP  cards  are  also  required. 


Exhibit  4 
Page  20  of  41 


QD 
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QM 


*  QD  Card  -  Varying  Desired  Flows 

This  card  specifies  periodically  varying  mini nun  desired  flows  at 
this  control  point.  If  NPER  is  greater  "than  10,  two  cards  are  required. 

Variable  Value  Description 

Qill'J  +  Minimum  desired  flow  in  standard  flow 

units  (cfs  or  m3/sec)  unless  nonstandard 
units  have  been  specified  by  CNSTO 
(J2  card,  field  6).  Specify  NPER  (J5 
card,  field  1)  values  in  successive 
order,  one  value  per  field.  The  first 
value  must  be  the  value  for  period 
number  IPERA  (05  card,  field  2). 

*  QR  Card  -  Varying  Required  Tlows 

This  card  specifies  minimum  required  flows  at  this  control  point. 

If  NPER  is  greater  than  10,  two  cards  are  required. 


Field 

1-10 


Field  Variable  Value  Description 

1-10  QMIN2  +  Minimum  required  flow.  Comments  on 

units,  number  of  values  and  order  of 
values  are  same  as  for  QMII1,  above. 

*  qm  Card  -  Maximum  Permissible  Flows 

This  card  specifies  maximum  permissible  flows  at  this  control  point. 

If  NPER  is  greater  than  10,  two  cards  are  required. 

Field  Variable  Value  Description 

1-10  QiTX  +  Maximum  permissible  flow.  Comments  on 

units,  number  of  values,  and  order  of 
values  are  same  as  for  QMIfl  (QD  card). 


♦Optional  card 
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D.  Reservoir  Subset  (cards  Rl-RE) 
if  R1  Card  -  First  Reservoir  Card 

This  card  specifies  some  physical  characteristics  of  a  reservoir  at 
this  control  point.  Omit  cards  R1 - PR  i f  there  is  no  reservoir  at  this 
control  point;  then  the  next  card  will  be  CP  card  for  next  control  point, 
or  ED  card  of  this  is  the  most  downstream  control  point  in  the  system. 


Field  Variable  Value 

1  CEVAP  + 

2  ST0R1  + 


-1 


3  QLKG  + 


4  ISRCH  0 


+ 


5-10 


Description 

Ratio  of  net  reservoir  evaporation  at 
this  reservoir  to  index  evaporation 
(J3,  YE  or  EV  cards) . 

Initial  storage  in  standard  volume 
units  (acre-feet  or  thousand  cubic 
meters). 

If  this  is  a  second  set  of  data  follow¬ 
ing  a  complete  data  set  in  which  IUPDT 
(J3  card,  field  4)  was  positive  and  if 
routing  is  to  continue  using  ending 
storage  from  last  period  of  prior 
routing,  specify  -1. 

Leakage  through  or  under  dam  or  power¬ 
house  in  standard  flow  units  (cfs  or  nr/sec), 
normally  only  used  to  specify  water  which 
continuously  passes  the  dam  but  cannot 
be  used  for  po wer  generation. 

If  zero  or  blank,  no  spillway  surcharge 
allowed,  and  excess  flood  flows  will  be 
spilled  when  storage  exceeds  top  of 
flood  control  pool  (Jl,  field  3). 

Positive  value  allows  spillway  surcharge. 

The  flood  releases  above  top  of  flood  con¬ 
trol  pool  will  be  limited  to  the  specified 
outflow  capacity  (RS  and  RQ  cards). 

.Not  used. 


^Required  for  all  reservoirs. 


Exhibit  4 
Page  22  of  41 


RL 


RL  Card  -  Reservoir  Target  Levels 

This  set  of  cards  specifies  ,'IL  (J1  card,  field  3)  target  storage 
levels  for  this  reservoir.  At  least  four  levels  are  required.  The 
lowest  level  is  always  the  bottom  of  the  conservation  pool,  and  the 
second  level  is  always  the  top  of  the  buffer  storage  zone.  If  there 
is  no  buffer  storage,  target  storages  for  levels  1  and  2  will  be 
identical  each  period.  The  highest  level  (level  ML)  is  always  the 
full  pool  level  (top  of  flood  control).  In  conservation  routings,  the 
second  highest  level  is  always  the  top  of  the  conservation  pool.  In  a 
reservoir  with  no  flood  control  storage  the  two  highest  levels  will  be 
identical  for  each  period.  Tor  reservoirs  with  no  active  storage  (such 
as  run-of-river  power  projects)  all  levels  will  be  identical  for  all 
periods.  In  the  case  of  a  run-of-river  power  project  the  storage  value 
specified  for  all  levels  should  be  the  storage  corresponding  to  the 
pool  elevation  at  wnich  the  average  head  can  be  developed.  If  more 
than  one  card  is  required  to  specify  the  storages  at  any  one  level,  the 
values  on  the  second  card  should  start  in  field  5.  The  cards  for  each 
level  can  be  read  in  any  order.  When  cards  are  omitted  for  a  given 
level,  storages  are  assumed  equal  to  the  next  lower  level. 


Field  Variable  Value 

1  L  + 

2  ,1  + 

3  IRPT  0 

-1 


4  FACTR  0 

+ 

5-10  STORL  + 


#Required  for  all  reservoirs. 


description 
Level  number. 

Control  point  number.  Must  correspond 
to  II  on  CP  card,  field  1. 

Storages  will  be  read  for  all  periods. 

Two  RL  cards  are  required  if  NPER  (J5 
card,  field  1)  is  greater  than  6. 

The  STORL  value  specified  in  field  5 
(multiplied  by  FACTR)  will  be  repeated 
for  the  entire  NPER  periods.  Only  one 
card  per  level  is  required. 

Default  value  of  1.0  is  assigned. 

Factor  by  which  STORL  will  be  multiplied. 

Storage  in  acre-feet  (or  thousand  cubic 
meters)  for  target  level.  Used  to 
balance  storage  among  reservoirs  in 
supplying  system  water  and  power  demands. 
Beginning  with  the  lowest  level,  specify 
a  storage  value  for  each  period  until 
NPER  (J5  card,  field  1)  values  have  been 
specified  for  that  level.  The  first 
value,  which  will  appear  in  field  5,  must 
be  the  storage  level  for  period  number 
IPERA  (05  card,  field  2).  If  more  than 
six  values  are  used,  the  remaining  values 
start  in  field  5  of  the  following  card. 
Fields  1  through  4  of  the  second  RL  cards 
of  the  same  level  are  left  blank. 
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if  RS  Card^-  Reservoir  Storages 

This  card  specifies  the  reservoir  storage  capacity  table.  As  many 
as  ten  (limited  by  dimension)  values  may  be  used. 

Field  Variable  Value  Description 

1-10  STOR  +  Reservoir  storage  capacity  in  acre- 

feet  (or  thousand  cubic  meters). 

Specify  up  to  ten  values,  beginning 
with  the  smallest  value  in  field  1. 

Each  value  must  be  equal  to  or  larger 
than  the  preceding  one.  The  smallest 
value  should  be  smaller  than  the  storage 
for  the  lowest  level,  and  the  largest 
value  should  be  as  large  or  larger  than 
the  storage  for  the  largest  level.  If 
ten  values  are  not  needed,  the  unneeded 
fields  should  be  left  blank.  Since  the 
program  interpolates  linearly  in  this 
table  and  in  the  tables  on  the  RE,  RA 
and  RQ  cards,  and  since  the  values  on 
the  RE,  RA  and  RQ  cards  must  correspond 
to  the  storage  values  on  this  card,  the 
storage  values  should  be  selected  so  as 
to  make  linear  interpolation  relatively 
accurate  between  any  two  points  on  any 
of  the  four  tables.  Storage  values  should 
be  selected  to  correspond  with  major  dis¬ 
continuities  in  any  of  the  other  three 
tables. 

ff  RA  Card  -  Reservoir  Areas 


This  card  specifies  the  reservoir  surface  areas  corresponding  to  the 
storage  capacities  specified  on  the  RS  card. 


Field 

Variable 

Value 

Description 

1-10 

AREA 

+ 

Reservoir  surface  area  in  acres  (or 
thousand  square  meters)  corresponding 
to  storage  capacity  in  same  field  on 
the  RS  card. 

#fiequired  for  all  reservoirs. 

^ Cards  RS-RE  are  entered  as  a  set  for  each  reservoir.  All  four  cards  are 
required  for  every  reservoir.  Each  card  in  the  set  for  a  given  reservoir 
must  contain  the  same  number  of  data  items.  However,  it  is  not  necessary 
to  use  the  same  number  of  data  items  for  all  reservoirs. 
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#  RQ  Card  -  Reservoir  Outlet  Capacities 

This  card  specifies  reservoir  outlet  capacities  corresponding  to 
the  storage  capacities  specified  on  the  RS  card. 


Value  Description 

+  Total  reservoir  outlet  capacity  (including 
conduits,  turbines  and  spillways)  in  cfs 
(or  nr/sec)  corresponding  to  storage  capacity 
in  same  field  on  the  RS  card.  Special 
care  is  needed  to  define  this  table  properly 
to  describe  abrupt  changes  resulting  at  con¬ 
duit  inverts,  changes  in  flow  control  and 
spillway  crests. 

#  RE  Card  -  Reservoir  Elevations 


Field  Variables 
1-10  QCAP 


This  card  specifies  the  reservoir  elevations  corresponding  to  the 
storage  capacities  specified  on  the  RS  card. 


Field  Variable  Value 


Description 


1-10  EL  +  Reservoir  elevation  in  feet  (or  meters 

corresponding  to  storage  capacity  in 
same  field  on  the  RS  card. 


^Required  for  all  reservoirs. 
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E.  Power  Subset  (cards  PI -PE) 


M  PI  Card  -  First  Power  Card 

Tin's  card  specifies  physical  characteristics  of  a  powerplant  located 
at  this  control  point.  Omit  cards  PI -PR  if  no  powerplant  exists  at  this 
control  point;  next  card  will  be  CP  card  for  next  control  point,  or  ED 
card  if  this  is  the  most  downstream  control  point. 


Field 

Variable 

Value 

Description 

1 

OVLOD 

+ 

Overload  ratio  for  the  power  installation. 
Usually  1.15  in  the  United  States.  If  left 
blank,  program  assumes  1.15. 

2 

PWRMX 

+ 

installed  powerplant  nameplate  capacity  in 
kilowatts.  Station  service  units  are 
usually  excluded. 

3 

TLWEL 

+ 

Tailwater  elevation  plus  hydraulic  loss 
in  feet  (or  meters).  For  hydroelectric 
projects  providing  "peaking"  power,  this 
should  be  a  "block-loading"  or  average 
"on-line"  tailwater  elevation  that  would 
be  expected  normally  during  periods  of 
power  generation. 

0 

Zero  or  blank  indicates  that  a  tailwater 
vs.  reservoir  release  relationship  will 
he  read  on  the  PQ  and  PT  cards. 

4 

I  DPR 

0 

Zero  or  blank  indicates  that  there  is  no 
downstream  reservoir  whose  elevation 
affects  tailwater  elevation  at  this  power- 
plant. 

+ 

Control  point  number  of  downstream  reservoir 
whose  elevation  affects  tailwater  elevation 
at  this  powerplant.  Program  adds  2.0  feet 
(.6  meters)  for  hydraulic  loss  to  elevation 
of  downstream  reservoir  to  obtain  tailwater 
elevation  ana  uses  that  or  TLWEL  (field  1) 
depending  on  which  is  highest  for  computing 
power  head. 

^Required  card  for  all  reservoirs  with  powerplants. 
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PI 


PI  Card  (continued) 


Field 

5 


6 


Variable  Value  Inscription 

IPOW  0  Zero  or  blank  specifies  that  pov/er  peaking 

capability  function  will  not  be  used.  This, 
in  effect,  means  that  the  only  limitation 
of  power  output  will  be  the  powerplant 
nameplate  capacity. 


1  Value  of  1  indicates  that  a  peaking 

capability  vs.  reservoir  storage  relation¬ 
ship  will  be  read  in  on  cards  PP  and  PS 
and  used  to  calculate  the  turbine-generator 
capability  as  a  function  of  reservoir  storage. 
This  option  is  used  when  head  fluctuations 
are  primarily  dependent  on  headwater  fluctua¬ 
tions. 


Value  of  2  indicates  that  a  peaking  capabil¬ 
ity  vs.  reservoir  release  relationship  will 
be  read  in  on  cards  PP  and  PS  and  used  to 
calculate  the  turbine-generator  capability 
as  a  function  of  reservoir  release.  This 
option  is  used  when  the  head  fluctuations 
are  primarily  dependent  on  changes  in 
tail  water. 


EFFCY 


0  Standard  ratio  of  .86  is  used. 

+  Powerplant  efficiency  at  this  installation 
expressed  as  a  ratio.  Specification  of  a 
positive  value  implies  that  efficiency  is 
constant  throughout  the  range  of  operating 
heads  anticipated. 

-1  If  -1  is  specified,  powerplant  efficiency 
vs.  reservoir  storage  relationship  is 
specified  on  PE  card. 

-2  If  -2  is  specified,  KW/CFS  (or  KW/m^sec) 

coefficient  vs.  reservoir  storage  relation¬ 
ship  is  specified  on  PE  card. 
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PR 

PI  Card  (continued) 

Field  Variable  Value  Description 

7  MPSYS  0  Zero  or  blank  indicates  that  this  power- 

plant  does  not  function  as  part  of  a 
power  system. 

+  Specify  the  power  system  number  (1  or  2) 
for  the  power  system  in  which  this  power- 
plant  is  to  operate.  As  many  as  two  power 
systems  are  permitted. 

8  PFMAX  +  Maximum  plant  factor  for  generation  from 

this  project  to  contribute  to  meeting 
system  power  load.  Must  be  equal  to  or 
less  than  OVLOD  (field  1).  Generation 
of  rates  greater  than  indicated  by  PFMAX 
will  be  permitted  when  excess  water  is 
available,  but  only  the  portion  of  genera¬ 
tion  up  to  PFMAX  is  considered  to  be 
useable  in  meeting  the  system  load. 

9-10  Hot  used. 

if#  PR  Card  -  Enerqy  Requirements  (Card  can  be  omitted  if  YP  card  is  used 
each  year  for  this  reservoir.) 

This  card  specifies  the  at-site  enerqy  requirements  for  this  project 
for  each  period.  If  MPER  (J5  card,  field  1)  is  greater  than  10,  two 
cards  are  required. 

Field  Variable  Value  Oescri ption 

1-10  POWR  +  At-site  enerov  requirement  in  thousand  kwh. 

Specify  MPER  (J5  card,  field  1)  values  in 
successive  order,  one  value  per  field.  The 
first  value  must  be  the  value  for  period 
number  IPERA  (J5  card,  field  2). 

At-site  enerqv  requirements  as  plant  factor 
ratio  tines  -1.0.  Specify  HPER  values  as 
above. 


##Required  for  each  powerplant. 
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*  PQ  Card^-  Power  Releases 


Field  Variable  Value 


*  PT  Card^-  Power  Tail  water 


Description 

Reservoir  outflow  in  cfs  (or  m3/sec).  Begin 
with  lowest  value  in  field  1  and  specify 
values  in  increasing  order.  Values  should 
cover  the  range  of  discharges  expected. 
Program  uses  linear  interpolation  between 
points,  so  values  should  be  selected  so 
that  linear  interpolation  is  reasonably 
accurate.  If  less  than  ten  values  are 
needed,  the  unneeded  fields  should  be 
left  blank. 


The  number  of  values  on  this  card  must  be  the  sane  as  the  number  of 
values  on  the  PQ  card. 


Field 


Variable  Value 


Description 


Tail water  elevation  in  feet  (or  meters) 
corresponding  to  reservoir  outflow  in 
same  fields  on  the  PQ  card. 


♦Optional  card 

^Cards  PQ  and  PT  are  used  to  specify  the  tailwa tor-discharge  relationship 
at  this  powerplant  instead  of  using  TLWCL  (PI  card,  field  1 ).  dp  to  ten 
values  can  be  used  to  define  the  relationship. 
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PP  Card  -  Power  Peaking  Capability 

Field  Variable  Value  Description 

1-10  PKPWR  +  Maximum  peakinq  capability  in  kilowatts. 

Begin  with  smallest  capability  in  first 
field  and  specify  values  in  ascendinq 
order.  Program  uses  linear  interpolation 
in  this  table  so  values  should  be  selected 
so  that  linear  interpolation  is  reasonably 
accurate.  If  less  than  ten  values  are 
needed,  the  unneeded  fields  should  be 
left  blank. 

PS  Card^ -  Power  Storages  (or  Releases) 

The  data  on  tin's  card  can  be  either  reservoir  releases  or  reservoir 
storages.  Reservoir  storages  are  specified  if  IP01!  (PI  card,  i i eld  5) 
is  1,  and  reservoir  releases  are  specified  if  IPO'.!  is  2.  The  number  of 
values  on  this  card  must  be  the  same  as  the  number  on  the  PP  card.  The 
largest  should  be  larger  than  the  highest  storage  or  largest  release 
anticipated  and  the  smallest  value  should  be  smaller  than  the  lowest 
storage  or  smallest  release  anticipated. 

Field  Variable  Value  Description 

1-19  CQOEL  +  Reservoir  storage  in  acre-feet  (or  thousand 

cubic  meters)  if  IPO'.J  (PI  card,  field  5) 
is  1,  or  reservoir  release  in  cfs  (or  m3/sec) 
if  IPOli  is  2.  Values  must  correspond  to 
peakinq  capabilities  in  same  field  on  the 
PP  card.  Each  succeeding  value  must  be 
larger  than  the  last  value. 


Optional  cards 

^Cards  PP  and  PS  define  the  relationship  between  peaking  capability  and 
either  reservoir  storage  or  reservoir  outflow.  PI  card,  field  5  must 
be  equal  to  1  or  2  to  determine  type  of  data  being  read.  Up  to  ten 
values  can  be  used  to  define  the  relationship. 
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*  PE  Card  -  Power  Efficiencies  vs.  Storage 


This  card  is  used  to  specify  the  relationship  between  reservoir 
storage  and  either  plant  efficiency  ratio  or  KW/CFS  coefficient  instead 
of  using  a  fixed  efficiency  of  EFFCY  (PI  card,  field  C).  If  EFFCY  is 
specified  as  -1,  plant  efficiency  ratios  are  specified  on  this  card.  If 
EFFCY  is  specified  as  -2,  KW/CFS  (or  KW/m-Vsec)  coefficients  are  specified. 
The  number  of  values  on  this  card  must  be  the  same  as  the  number  of  values 
on  the  R$  card. 

Field  Variable  Value  Description 

1-10  EFCY  +  Plant  efficiency  ratio  if  EFFCY  (PI  card, 

field  6)  is  -1,  or  KW/CFS  (or  KW/m3/sec) 
coefficient  if  EFFCY  is  -2.  Values 
must  correspond  to  storaqe  capacities 
in  same  field  on  the  RS  card. 

Repeat  CP-PE  cards  for  each  control  point  in  downstream  order.  ED  card 
follows  last  control  point. 


F.  End  of  Control  Point  Data 


ED  Card 


Card  with  characters  ED  punched  in  columns  1  and  2  to  end  reading 
control  point  sequence  cards  CP-PC  for  last  control  point 


*0ptional  card 
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G .  Annual  Data  (Note  Change  in  Format)^ 
**  IN  Card  -  Yearly  Inflows 

Inflow  cards  for  each  station  specified  on  LF  cards. 


Field  Variable 

Value 

Description 

1  M 

+ 

Identification  number  of  input  inflows 
(columns  3-6),  Must  be  less  than  40. 

2  IDT 

+ 

Last  2  digits  of  year  (columns  7  &  8). 

3-14  QII 

+ 

Inflows  in  units  corresponding  to  CNSTI, 
NPER  items  per  station  (12  fields  of  6 
columns  each,  with  first  field  in  columns 
9-14  on  all  cards). 

YE  Card  -  Yearly  Index  Evaporation 

New  evaporation 
EV  cards. 

for  each  year  to  be  applied  to  all  reservoirs  without 

Field  Variable 

Value 

Description 

1 

Not  used  (columns  3-6). 

2  IDT 

+ 

Last  2  digits  of  year  (columns  7  &  8). 

3-14  EVAPO 

+ 

Net  index  evaporation  in  inches  (mm)  for 
each  successive  period,  NPER  items  (12 

fields  of  6  columns  each,  with  first 
field  in  columns  9-14  on  all  cards). 


*  Optional  cards 

**Required  cards  for  all  identification  numbers  that  are  referenced  on 
the  LF  cards  and  those  control  points  without  LF  cards.  NY°S  (01, 
field  1)  cards  for  each  control  point. 

^Repeat  cards  IN-YL  as  required  for  each  year  (NYRS  sets). 
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*  EV  Card 


EV 

YD 


New  evaporation  for  control  point  (reservoir)  M  for  each  year.  The 
reservoir  identification  numbers  must  be  in  the  same  order  as  the  reservoirs 
were  entered  as  control  points. 


Field 

Vari able 

Value 

Description 

1 

M 

+ 

Reservoir  identification  number  (columns 
3-6). 

2 

IDT 

Last  2  digits  of  year  (columns  7  &  8). 

3-14 

*  YD  Card 

EVP 

+ 

NPER  values  of  evaporation  in  inches  (mmj 
for  reservoir  M.  (12  fields  of  6  columns 
each,  with  first  field  in  columns  9-14  on 
all  cards.) 

New  diversion  requirement  for  each  year. 


Field 

Variable 

Value 

Description 

1 

M 

+ 

Control  point  identification  number 
(columns  3-6). 

2 

IDT 

+ 

Last  2  digits  of  year  (columns  7  &  8). 

3-14 

QDIV 

+ 

Diversion,  in  units  corresponding  to 
CNSTO  (J2  card,  field  6),  for  each 
successive  period,  NPER  values.  (12 
fields  of  6  columns  each,  with  first 
field  in  columns  9-14  of  all  cards.) 

♦Optional  cards 
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YP 

YS 


*  YP  Card 


New  power  requirement  for  each  powerplant  each  year. 

Field  Variable  Value  Description 

1  Columns  3-6  not  used. 

2  IDT  +  Last  2  digits  of  year  (colunns  7  &  8). 

3-14  POWR  +  Energy  requirements  for  each  successive 

period  in  thousand  kilowatt-hours,  NPER 
values. 

-  Plant  factor  ratio,  NPER  values  (12  fields 
of  6  columns  each,  with  first  field  in 
columns  9-14  for  all  cards). 

*  YS  Card 


New  system  power  requirement  for  each  year.  One  set  per  system. 


Field 

Variable 

Value 

Description 

1 

Columns  3-6  not  used. 

2 

IDT 

+ 

Last  2  digits  of  year  (columns  7  &  8). 

3-14 

PWRS 

+ 

System  enerqy  requirement  in  thousand 
kilowatt-hours,  NPER  values  (12  fields 
of  6  columns  each,  with  first  field  in 
columns  9-14  for  all  cards). 

♦Optional  cards 
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Desired  low-flow  requirement  for  each  year. 


Field 

Variable 

Value 

Description 

1 

’1 

+ 

Control  point  identification  number 
(columns  3-6). 

O 

u 

IDT 

+ 

Last  2  digits  of  year  (columns  788). 

3-14 

QT1IN 

+ 

.Minimum  desired  flow  in  units  correspond¬ 
ing  to  CflSTO.  NPER  values  (12  fields  of 

6  columns  each,  with  first  field  in 
columns  9-14  for  all  cards). 

*  YL  Card 


Mew  storage  levels  for  each  year.  (Format  is  sane  as  RL  cards  - 
fields  of  8  columns.)  The  same  number  of  levels  must  be  supplied  each  year. 

Field  Variable  Value  Descriotion 


1  L 


+  Level  number. 


2 


+  Control  point  number. 


3  IRPT 

4  FACTR 

5-10  STORL 


Negative  number  indicates  that  the  storane 
in  field  5  is  to  be  repeated  for  all 
periods. 

0  Default  value  of  1.0  is  assigned. 

+  Factor  by  which  STORL  will  be  multiplied. 

+  Storage  in  acre-feet  (thousand  cubic 
meters).  'IPER  values,  unless  IRPT  is 
negative  in  which  case  only  one  value 
is  needed.  Vlhen  a  second  card  is 
required  skip  the  first  4  fields. 


Repeat  cards  Ifl  to  YL  as  required  for  each  year  (MYRS  sets). 

♦Optional  cards 
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H.  Benefit  Evaluation  Oata 


B.i  CarJ  -  benefit  Maries 

benefit  function  names  (up  to  60  characters).  3  cards  usino  columns 
3-C2.  'lust  Le  in  order  of  identification  in  the  3  fields  of  each  EC 
card. 


;P  Card  -  Ocnefit  -  Parameters  (fields  of  8  columns  except  for  field  1). 

3 

■Table  of  hydrologic  parameter,  flow  in  cfs  (m  /sec),  storage  in 
jere-feet  (thousand  cubic  meters),  or  energy  in  thousand  kilowatt-hours. 


field  Variable  Value 


Jescription 


0  MM 

1  M 

2  MTU 

3-10  HYVAL 


+  Benefit  function  number  used  only  as 
identification  (same  as  BV  card,  field 
1)  corresponding  to  field  number  of  EC 
card  for  control  point  M.  Ending  in 
column  4. 

+  Control  point  location  where  benefit 
is  evaluated  (ending  in  column  8). 

+  Sequence  nunber  of  last  period  where 
function  is  applicable  (not  necessar¬ 
ily  calendar  month  number).  Several 
sets  of  BP  and  BV  cards  can  be  used 
to  cover  the  NPER  periods.  Ending 
in  column  16. 

+  First  table  value  of  hydrologic  element 
in  units  corresponding  to  the  MM  field 
of  the  EC  card  for  station  M.  Up  to 
8  table  values  (full  card). 


*0ptional  cards 

#Table  cards  BP  and  BV  must  be  supplied  in  pairs  for  each  successive 
sequence  period  for  all  control  points  having  positive  indicator  on  EC 
card  for  each  economic  function  in  turn  (all  points  for  first  function, 
followed  by  all  points  for  second  function,  etc.).  Pairs  should  be 
omitted  if  the  function  for  the  following  period  is  identical,  except 
that  the  pair  for  the  last  period  must  be  supplied  (normally  MTH  *  12). 
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BV 


BV  Card  -  Benefit  Values  in  Fields  of  Eight  except  for  1st  Field 
Table  of  benefit  in  thousand  dollars  (see  example). 


Field 

Variable 

Value 

Description 

0 

MM 

+ 

Benefit  function  number,  used  only  as  identifi¬ 
cation.  Same  as  BP  card,  field  1.  Ending 
in  column  4. 

1 

M 

+ 

Station  number,  must  be  identical  to 
preceding  card.  Ending  in  column  8. 

2 

MTH 

+ 

Sequence  number,  must  be  identical  to 
preceding  card.  Ending  in  column  16. 

3-10 

ECVAL 

+ 

Economic  value  in  thousand  dollars  for 
corresponding  hydrologic  value  on  preced¬ 
ing  card,  etc.,  up  to  8  table  values. 
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ER 


I.  End  of  Run 

ER  Card  -  ER  punched  in  columns  1  and  2  should  follow  last  job  to  cause 
computer  to  stop. 
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SUMMARY  OF  IHPUT  CARDS 


ROUS: 

**  **ftequlrrd  cards 

ffttCulred  for  alt  reservoir* 
faftequircd  for  «1I  reMrvot'f  with  pcver plants 

1.  Default  value*  are  shown  below  Uelr  respective  variable  n**ei . 

2.  Card*  without  footnote*  *,  and  *t  are  optional  and  ran  be  omitted. 

3.  Columns  I  and  2  of  J6  card  arc  rot  reserved  for  identification. 

H.  Control  Point  card*  (CP -PE)  are  repotted,  a*  required,  for  each  Control  point  in 
turn  In  downstream  ordnr. 

$.  Reservoir  cards  (PI  •PC)  are  u**d.  aa  required,  for  all  reservoirs, 

6.  Power  card*  ( P I  -^3 )  are  uses,  as  required,  for  all  powerpl ant*. 

7.  CD  card  follows  cards  CP  •PE.  as  required,  for  last  control  point. 

6.  Annual  data  (card*  IN -Y L )  are  repeated,  as  required,  for  each  yt*r  (hfJS  sets). 

9.  Cards  BP  and  6V  «ust  be  supplied  In  pairs  for  each  successive  sequence  north  for 
all  control  points  having  positive  indicator  on  tC  card  for  esch  economic  function 
In  Urn. 

10.  Eft  card  should  follow  list  job  (TI-BV)  to  cause  computer  to  stop. 
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